rbexy 2.0.0.beta8 → 2.0.0.beta9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e6c7e84344a63e1d1992827aedcafdd968ce9372e35bb6a8d01e66b46be34e0
-  data.tar.gz: 497be0f074210d5f43efe9a38e72d41972b309fc8294fa413db097afdf0cb8e5
+  metadata.gz: df2f31c9d3f08e035f5c3d2a7cb7673f29abdb69d17805073df4f615d2000c81
+  data.tar.gz: cd5c8a28d438f1ce73b0aeb50434cf308dedd17d8e9604e67354686d064f699a
 SHA512:
-  metadata.gz: 8c18d3a259f7ce7ad630e2a39a8241ad0b6ce6bde8ea9ac55bd601cd6378b39e3201c011f8b6348bd4aaf86b780817a6b52db45cfa86a851e854b7c62cfb4285
-  data.tar.gz: dcf0db849b73ef8c817247c53812359273ed23f4016325288f91d066c449e41ddfc98cb94a924c2dc06ddf1f3d4e56f1998cc91728619c8ddd66c30f2f4faab2
+  metadata.gz: d4b9919d6e47c54a587bcc3be0c8f763b064f84544ac76c2e3b88b16870fe85100bbb597edeb11465aaa70b03ee92189fb7b8222865b0546455693d73b671bfb
+  data.tar.gz: 2f540c4199674536e55c9dce96cb03812c73251b349e1d222952c6eb12ce4d544a0c5e69e1f32fcedb770fa03aa50bce86f9848003d7da522d9f890e184a6dc2

data/.rspec

@@ -1 +1,2 @@
 --require spec_helper
+--exclude-pattern "integration/caching/**/*.rb"

data/.travis.yml

@@ -1,3 +1,5 @@
 language: ruby
 rvm:
  - 2.7
+ - 3.0
+script: bin/test

data/Dockerfile

@@ -1,4 +1,4 @@
-FROM ruby:2.7.1
+FROM ruby:3.0.0
 RUN apt-get update -qq
 
 WORKDIR /app

data/Dockerfile-ruby2

@@ -0,0 +1,7 @@
+FROM ruby:2.7.2
+RUN apt-get update -qq
+
+WORKDIR /app
+
+COPY . .
+RUN bundle install

data/Gemfile.lock

@@ -1,76 +1,80 @@
 PATH
   remote: .
   specs:
-    rbexy (2.0.0.beta8)
+    rbexy (2.0.0.beta9)
       actionview (>= 6.0, < 7.0)
       activesupport (>= 6.0, < 7.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (6.0.3.3)
-      actionpack (= 6.0.3.3)
+    actioncable (6.1.3)
+      actionpack (= 6.1.3)
+      activesupport (= 6.1.3)
       nio4r (~> 2.0)
       websocket-driver (>= 0.6.1)
-    actionmailbox (6.0.3.3)
-      actionpack (= 6.0.3.3)
-      activejob (= 6.0.3.3)
-      activerecord (= 6.0.3.3)
-      activestorage (= 6.0.3.3)
-      activesupport (= 6.0.3.3)
+    actionmailbox (6.1.3)
+      actionpack (= 6.1.3)
+      activejob (= 6.1.3)
+      activerecord (= 6.1.3)
+      activestorage (= 6.1.3)
+      activesupport (= 6.1.3)
       mail (>= 2.7.1)
-    actionmailer (6.0.3.3)
-      actionpack (= 6.0.3.3)
-      actionview (= 6.0.3.3)
-      activejob (= 6.0.3.3)
+    actionmailer (6.1.3)
+      actionpack (= 6.1.3)
+      actionview (= 6.1.3)
+      activejob (= 6.1.3)
+      activesupport (= 6.1.3)
       mail (~> 2.5, >= 2.5.4)
       rails-dom-testing (~> 2.0)
-    actionpack (6.0.3.3)
-      actionview (= 6.0.3.3)
-      activesupport (= 6.0.3.3)
-      rack (~> 2.0, >= 2.0.8)
+    actionpack (6.1.3)
+      actionview (= 6.1.3)
+      activesupport (= 6.1.3)
+      rack (~> 2.0, >= 2.0.9)
       rack-test (>= 0.6.3)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.0, >= 1.2.0)
-    actiontext (6.0.3.3)
-      actionpack (= 6.0.3.3)
-      activerecord (= 6.0.3.3)
-      activestorage (= 6.0.3.3)
-      activesupport (= 6.0.3.3)
+    actiontext (6.1.3)
+      actionpack (= 6.1.3)
+      activerecord (= 6.1.3)
+      activestorage (= 6.1.3)
+      activesupport (= 6.1.3)
       nokogiri (>= 1.8.5)
-    actionview (6.0.3.3)
-      activesupport (= 6.0.3.3)
+    actionview (6.1.3)
+      activesupport (= 6.1.3)
       builder (~> 3.1)
       erubi (~> 1.4)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.1, >= 1.2.0)
-    activejob (6.0.3.3)
-      activesupport (= 6.0.3.3)
+    activejob (6.1.3)
+      activesupport (= 6.1.3)
       globalid (>= 0.3.6)
-    activemodel (6.0.3.3)
-      activesupport (= 6.0.3.3)
-    activerecord (6.0.3.3)
-      activemodel (= 6.0.3.3)
-      activesupport (= 6.0.3.3)
-    activestorage (6.0.3.3)
-      actionpack (= 6.0.3.3)
-      activejob (= 6.0.3.3)
-      activerecord (= 6.0.3.3)
+    activemodel (6.1.3)
+      activesupport (= 6.1.3)
+    activerecord (6.1.3)
+      activemodel (= 6.1.3)
+      activesupport (= 6.1.3)
+    activestorage (6.1.3)
+      actionpack (= 6.1.3)
+      activejob (= 6.1.3)
+      activerecord (= 6.1.3)
+      activesupport (= 6.1.3)
       marcel (~> 0.3.1)
-    activesupport (6.0.3.3)
+      mimemagic (~> 0.3.2)
+    activesupport (6.1.3)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (>= 0.7, < 2)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-      zeitwerk (~> 2.2, >= 2.2.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+      zeitwerk (~> 2.3)
     builder (3.2.4)
     byebug (11.1.3)
     coderay (1.1.3)
-    concurrent-ruby (1.1.7)
+    concurrent-ruby (1.1.8)
     crass (1.0.6)
     diff-lcs (1.4.4)
-    erubi (1.9.0)
-    ffi (1.13.1)
+    erubi (1.10.0)
+    ffi (1.15.0)
     formatador (0.2.5)
     globalid (0.4.2)
       activesupport (>= 4.2.0)
@@ -88,12 +92,12 @@ GEM
       guard (~> 2.1)
       guard-compat (~> 1.1)
       rspec (>= 2.99.0, < 4.0)
-    i18n (1.8.5)
+    i18n (1.8.9)
       concurrent-ruby (~> 1.0)
-    listen (3.2.1)
+    listen (3.4.1)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
-    loofah (2.7.0)
+    loofah (2.9.0)
       crass (~> 1.0.2)
       nokogiri (>= 1.5.9)
     lumberjack (1.2.8)
@@ -105,12 +109,13 @@ GEM
     method_source (1.0.0)
     mimemagic (0.3.5)
     mini_mime (1.0.2)
-    mini_portile2 (2.4.0)
-    minitest (5.14.2)
+    mini_portile2 (2.5.0)
+    minitest (5.14.4)
     nenv (0.3.0)
-    nio4r (2.5.4)
-    nokogiri (1.10.10)
-      mini_portile2 (~> 2.4.0)
+    nio4r (2.5.7)
+    nokogiri (1.11.1)
+      mini_portile2 (~> 2.5.0)
+      racc (~> 1.4)
     notiffany (0.1.3)
       nenv (~> 0.1)
       shellany (~> 0.0)
@@ -120,36 +125,37 @@ GEM
     pry-byebug (3.9.0)
       byebug (~> 11.0)
       pry (~> 0.13.0)
+    racc (1.5.2)
     rack (2.2.3)
     rack-test (1.1.0)
       rack (>= 1.0, < 3)
-    rails (6.0.3.3)
-      actioncable (= 6.0.3.3)
-      actionmailbox (= 6.0.3.3)
-      actionmailer (= 6.0.3.3)
-      actionpack (= 6.0.3.3)
-      actiontext (= 6.0.3.3)
-      actionview (= 6.0.3.3)
-      activejob (= 6.0.3.3)
-      activemodel (= 6.0.3.3)
-      activerecord (= 6.0.3.3)
-      activestorage (= 6.0.3.3)
-      activesupport (= 6.0.3.3)
-      bundler (>= 1.3.0)
-      railties (= 6.0.3.3)
+    rails (6.1.3)
+      actioncable (= 6.1.3)
+      actionmailbox (= 6.1.3)
+      actionmailer (= 6.1.3)
+      actionpack (= 6.1.3)
+      actiontext (= 6.1.3)
+      actionview (= 6.1.3)
+      activejob (= 6.1.3)
+      activemodel (= 6.1.3)
+      activerecord (= 6.1.3)
+      activestorage (= 6.1.3)
+      activesupport (= 6.1.3)
+      bundler (>= 1.15.0)
+      railties (= 6.1.3)
       sprockets-rails (>= 2.0.0)
     rails-dom-testing (2.0.3)
       activesupport (>= 4.2.0)
       nokogiri (>= 1.6)
     rails-html-sanitizer (1.3.0)
       loofah (~> 2.3)
-    railties (6.0.3.3)
-      actionpack (= 6.0.3.3)
-      activesupport (= 6.0.3.3)
+    railties (6.1.3)
+      actionpack (= 6.1.3)
+      activesupport (= 6.1.3)
       method_source
       rake (>= 0.8.7)
-      thor (>= 0.20.3, < 2.0)
-    rake (12.3.3)
+      thor (~> 1.0)
+    rake (13.0.3)
     rb-fsevent (0.10.4)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
@@ -186,14 +192,13 @@ GEM
       activesupport (>= 4.0)
       sprockets (>= 3.0.0)
     sqlite3 (1.4.2)
-    thor (1.0.1)
-    thread_safe (0.3.6)
-    tzinfo (1.2.7)
-      thread_safe (~> 0.1)
+    thor (1.1.0)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
     websocket-driver (0.7.3)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.5)
-    zeitwerk (2.4.0)
+    zeitwerk (2.4.2)
 
 PLATFORMS
   ruby
@@ -211,4 +216,4 @@ DEPENDENCIES
   sqlite3
 
 BUNDLED WITH
-   2.1.4
+   2.2.3

data/README.md

@@ -2,6 +2,19 @@
 
 [![Build Status](https://travis-ci.org/patbenatar/rbexy.svg?branch=master)](https://travis-ci.org/patbenatar/rbexy)
 
+* [Getting Started](#getting-started-with-rails)
+* [Template Syntax](#template-syntax)
+* [Components](#components)
+  * [`Rbexy::Component`](#rbexycomponent)
+  * [Usage with any component library](#usage-with-any-component-library)
+* [Fragment caching in Rails](#fragment-caching-in-rails)
+* [Advanced](#advanced)
+  * [Component resolution](#component-resolution)
+  * [AST Transforms](#ast-transforms)
+  * [Usage outside of Rails](#usage-outside-of-rails)
+
+## Manifesto
+
 Love JSX and component-based frontends, but sick of paying the costs of SPA development? Rbexy brings the elegance of JSX—operating on HTML elements and custom components with an interchangeable syntax—to the world of Rails server-rendered apps.
 
 Combine this with CSS Modules in your Webpacker PostCSS pipeline and you'll have a first-class frontend development experience while maintaining the development efficiency of Rails.
@@ -85,78 +98,25 @@ Add a controller, action, route, and `rbx` view like `app/views/hello_worlds/ind
 </HelloWorld>
 ```
 
-_Or you can render Rbexy components from ERB with `<%= HelloWorldComponent.new(self, name: "Nick").render %>`_
-
 Fire up `rails s`, navigate to your route, and you should see Rbexy in action!
 
 ## Template Syntax
 
-### Text
-
-You can put arbitrary strings anywhere.
-
-At the root:
-
-```jsx
-Hello world
-```
-
-Inside tags:
-
-```jsx
-<p>Hello world</p>
-```
-
-As attributes:
-
-```jsx
-<div class="myClass"></div>
-```
-
-### Comments
-
-Start a line with `#` to leave a comment:
-
-```jsx
-# Comments can be at the root
-<div>
-  # Or within tags
-  # spanning multiple lines
-  <h1>Hello world</h1>
-</div>
-```
-
-### Expressions
-
-You can put ruby code anywhere that you would put text, just wrap it in `{ ... }`
-
-At the root:
-
-```jsx
-{"hello world".upcase}
-```
-
-Inside a sentence:
-
-```jsx
-Hello {"world".upcase}
-```
-
-Inside tags:
+You can use Ruby code within brackets:
 
 ```jsx
-<p>{"hello world".upcase}</p>
+<p class={@dynamic_class}>
+  Hello {"world".upcase}
+</p>
 ```
 
-As attributes:
+You can splat a hash into attributes:
 
 ```jsx
-<p class={@dynamic_class}>Hello world</p>
+<div {**{class: "myClass"}} {**@more_attrs}></div>
 ```
 
-#### Tags within expressions
-
-To conditionalize your template:
+You can use HTML or component tags within expressions. e.g. to conditionalize a template:
 
 ```jsx
 <div>
@@ -165,7 +125,7 @@ To conditionalize your template:
 </div>
 ```
 
-Loops:
+Or in loops:
 
 ```jsx
 <ul>
@@ -181,7 +141,7 @@ Blocks:
 end}
 ```
 
-As an attribute:
+Pass a tag to a component as an attribute:
 
 ```jsx
 <Hero title={<h1>Hello World</h1>}>
@@ -189,7 +149,7 @@ As an attribute:
 </Hero>
 ```
 
-Pass a lambda to a prop, that when called returns a tag:
+Or pass a lambda as an attribute, that when called returns a tag:
 
 ```jsx
 <Hero title={-> { <h1>Hello World</h1> }}>
@@ -207,70 +167,15 @@ _Note that when using tags inside blocks, the block must evaluate to a single ro
 -> { <i>Hello</i> World }
 ```
 
-### Tags
-
-You can put standard HTML tags anywhere.
-
-At the root:
-
-```jsx
-<h1>Hello world</h1>
-```
-
-As children:
-
-```jsx
-<div>
-  <h1>Hello world</h1>
-</div>
-```
-
-As siblings with other tags:
-
-```jsx
-<div>
-  <h1>Hello world</h1>
-  <p>Welcome to rbexy</p>
-</div>
-```
-
-As siblings with text and expressions:
-
-```jsx
-<h1>Hello world</h1>
-{an_expression}
-Some arbitrary text
-```
-
-Self-closing tags:
-
-```jsx
-<input type="text" />
-```
-
-#### Attributes
-
-Text and expressions can be provided as attributes:
-
-```jsx
-<div class="myClass" id={dynamic_id}></div>
-```
-
-Value-less attributes are allowed:
-
-```jsx
-<input type="submit" disabled>
-```
-
-You can splat a hash into attributes:
+Start a line with `#` to leave a comment:
 
 ```jsx
-<div {**{ class: "myClass" }} {**@more_attrs}></div>
+# Private note to self that won't be rendered in the final HTML
 ```
 
-## Custom components
+## Components
 
-You can use custom components alongside standard HTML tags:
+You can use Ruby classes as components alongside standard HTML tags:
 
 ```jsx
 <div>
@@ -281,6 +186,8 @@ You can use custom components alongside standard HTML tags:
 </div>
 ```
 
+By default, Rbexy will resolve `PageHeader` to a Ruby class called `PageHeaderComponent` and render it with the view context, attributes, and its children: `PageHeaderComponent.new(self, title: "Welcome").render_in(self, &block)`. This behavior is customizable, see "Component resolution" below.
+
 ### `Rbexy::Component`
 
 We ship with a component superclass that integrates nicely with Rails' ActionView and the controller rendering context. You can use it to easily implement custom components in your Rails app:
@@ -301,13 +208,11 @@ By default, we'll look for a template file in the same directory as the class an
 <h1>{@title}</h1>
 ```
 
-You can call this component from another `.rbx` template file (`<PageHeader title="Hello" />`)—either one rendered by another component class or a Rails view file like `app/views/products/index.rbx`. Or you can call it from ERB (or any other template language) like `PageHeaderComponent.new(self, title: "Hello").render_in`.
-
-Your components and their templates run in the same context as traditional Rails views, so you have access to all of the view helpers you're used to as well as any custom helpers you've defined in `app/helpers/`.
+Your components and their templates run in the same context as traditional Rails views, so you have access to all of the view helpers you're used to as well as any custom helpers you've defined in `app/helpers/` or via `helper_method` in your controller.
 
 #### Template-less components
 
-If you'd prefer to render your components entirely from Ruby, e.g. using Rails `tag` helpers, you can do so with `#call`:
+If you'd prefer to render your components entirely from Ruby, you can do so by implementing `#call`:
 
 ```ruby
 class PageHeaderComponent < Rbexy::Component
@@ -361,106 +266,136 @@ class TextFieldComponent < Rbexy::Component
 end
 ```
 
-### `ViewComponent`
+#### Usage with ERB
 
-Using Github's view_component library? Rbexy ships with a provider that'll resolve your RBX tags like `<Button />` to their corresponding `ButtonComponent < ViewComponent::Base` components.
+We recommend using `Rbexy::Component` with the rbx template language, but if you prefer ERB... a component's template can be `.html.erb` and you  can render a component from ERB like so:
 
-```ruby
-require "rbexy/component_providers/view_component_provider"
+Rails 6.1:
+
+```erb
+<%= render PageHeaderComponent.new(self, title: "Welcome") do %>
+  <p>Children...</p>
+<% end >
+```
 
+Rails 6.0 or earlier:
+
+```erb
+<%= PageHeaderComponent.new(self, title: "Welcome").render_in(self) %>
+```
+
+### Usage with any component library
+
+You can use the rbx template language with other component libraries like Github's view_component. You just need to tell Rbexy how to render the component:
+
+```ruby
+# config/initializers/rbexy.rb
 Rbexy.configure do |config|
-  config.component_provider = Rbexy::ComponentProviders::ViewComponentProvider.new
+  config.component_rendering_templates = {
+    children: "{capture{%{children}}}",
+    component: "::%{component_class}.new(%{view_context},%{kwargs}).render_in%{children_block}"
+  }
 end
 ```
 
-### Other types of components
+## Fragment caching in Rails
 
-You just need to tell rbexy how to resolve your custom component classes as it encounters them while evaluating your template by implementing a ComponentProvider:
+`.rbx` templates integrate with Rails fragment caching, automatically cachebusting when the template or its render dependencies change.
 
-```ruby
-class MyComponentProvider
-  def match?(name)
-    # Return true if the given tag name matches one of your custom components
-  end
+If you're using `Rbexy::Component`, you can further benefit from component cachebusting where the fragment cache will be busted if any dependent component's template _or_ class definition changes.
 
-  def render(context, name, **attrs, &block)
-    # Instantiate and render your custom component for the given name, using
-    # the render context as needed (e.g. ActionView in Rails)
-  end
-end
+And you can use `<Rbexy.Cache>`, a convenient wrapper for the Rails fragment cache:
+
+```rbx
+<Rbexy.Cache key={...}>
+  <p>Fragment here...</p>
+  <MyButton />
+</Rbexy.Cache>
+```
+
+## Advanced
+
+### Component resolution
+
+By default, Rbexy resolves component tags to Ruby classes named `#{tag}Component`, e.g.:
 
-# Register your component provider with Rbexy
+* `<PageHeader />` => `PageHeaderComponent`
+* `<Admin.Button />` => `Admin::ButtonComponent`
+
+You can customize this behavior by providing a custom resolver:
+
+```ruby
+# config/initializers/rbexy.rb
 Rbexy.configure do |config|
-  config.component_provider = MyComponentProvider.new
+  config.element_resolver = MyResolver.new
 end
 ```
 
-Or in Rails you can customize the component provider just for a controller:
+Where `MyResolver` implements the following API:
+
+* `component?(name: string, template: Rbexy::Template) => Boolean`
+* `component_class(name: string, template: Rbexy::Template) => T`
+
+See `lib/rbexy/component_resolver.rb` for an example.
+
+#### Auto-namespacing
+
+Want to namespace your components but sick of typing `Admin.` in front of every component call? Rbexy's default `ComponentResolver` implementation has an option for that:
 
 ```ruby
-class ThingsController < ApplicationController
-  def rbexy_component_provider
-    MyComponentProvider.new
-  end
+# config/initializers/rbexy.rb
+Rbexy.configure do |config|
+  config.element_resolver.component_namespaces = {
+    Rails.root.join("app", "views", "admin") => %w[Admin],
+    Rails.root.join("app", "components", "admin") => %w[Admin]
+  }
 end
 ```
 
-See `lib/rbexy/component_providers/` for example implementations.
+Now any calls to `<Button>` made from `.rbx` views within `app/views/admin/` or from component templates within `app/components/admin/` will first check for `Admin::ButtonComponent` before `ButtonComponent`.
 
-## Usage outside of Rails
+### AST Transforms
 
-Rbexy compiles your template into ruby code, which you can then execute in any context you like, so long as a tag builder is available at `#rbexy_tag`. We provide a built-in runtime leveraging ActionView's `tag` helper that you can extend from or build your own:
+You can hook into Rbexy's compilation process to mutate the abstract syntax tree. This is both useful and dangerous, so use with caution.
 
-Subclass to add methods and instance variables that you'd like to make available to your template.
+An example use case is automatically scoping CSS class names if you're using something like CSS Modules. Here's an oversimplified example of this:
 
 ```ruby
-class MyRuntime < Rbexy::Runtime
-  def initialize
-    super
-    @an_ivar = "Ivar value"
-  end
-
-  def a_method
-    "Method value"
+# config/initializers/rbexy.rb
+Rbexy.configure do |config|
+  config.transforms.register(Rbexy::Nodes::HTMLAttr) do |node, context|
+    if node.name == "class"
+      class_list = node.value.split(" ")
+      node.value.content = scope_names(class_list, scope: context.template.identifier)
+    end
   end
 end
-
-Rbexy.evaluate("<p class={a_method}>{@an_ivar}</p>", MyRuntime.new)
 ```
 
-If you're using custom components, inject a ComponentProvider (see "Custom components" for an example implementation):
+### Usage outside of Rails
+
+Rbexy compiles your template into ruby code, which you can then execute in any context you like. Subclass `Rbexy::Runtime` to add methods and instance variables that you'd like to make available to your template.
 
 ```ruby
 class MyRuntime < Rbexy::Runtime
-  def initialize(component_provider)
-    super(component_provider)
-    @ivar_val = "ivar value"
+  def initialize
+    super
+    @an_ivar = "Ivar value"
   end
 
-  def splat_attrs
-    {
-      key1: "val1",
-      key2: "val2"
-    }
+  def a_method
+    "Method value"
   end
 end
 
-Rbexy.evaluate(
-  "<Forms.TextField /><Button prop1=\"val1\" prop2={true && \"val2\">Submit</Button>",
-  MyRuntime.new(MyComponentProvider.new)
-)
+Rbexy.evaluate("<p class={a_method}>{@an_ivar}</p>", MyRuntime.new)
 ```
 
-Or implement your own runtime, so long as it conforms to the API:
-
-* `#rbexy_tag` that returns a tag builder conforming to the API of `ActionView::Helpers::TagHelpers::TagBuilder`
-* `#evaluate(code)` that evals the given string of ruby code
-
 ## Development
 
 ```
 docker-compose build
-docker-compose run rbexy rspec
+docker-compose run rbexy bin/test
 ```
 
 Or auto-run tests with guard if you prefer:
@@ -471,7 +406,7 @@ docker-compose run rbexy guard
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/rbexy. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/rbexy/blob/master/CODE_OF_CONDUCT.md).
+Bug reports and pull requests are welcome on GitHub at https://github.com/patbenatar/rbexy. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/patbenatar/rbexy/blob/master/CODE_OF_CONDUCT.md).
 
 ## License
 
@@ -479,4 +414,4 @@ The gem is available as open source under the terms of the [MIT License](https:/
 
 ## Code of Conduct
 
-Everyone interacting in the Rbexy project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/rbexy/blob/master/CODE_OF_CONDUCT.md).
+Everyone interacting in the Rbexy project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/patbenatar/rbexy/blob/master/CODE_OF_CONDUCT.md).

data/bin/test

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+
+declare -i RESULT=0
+
+echo "Running main suite..."
+
+bundle exec rspec
+RESULT+=$?
+
+echo "Running initial caching specs to test cold cache behavior..."
+
+bundle exec rspec spec/integration/caching/before_changes_spec.rb
+RESULT+=$?
+
+echo "Making template source changes to allow testing of cache-busting..."
+
+templates=(
+  "spec/dummy/app/views/caching/inline.rbx"
+  "spec/dummy/app/components/cached_thing_component.rbx"
+  "spec/dummy/app/components/cached_class_thing_component.rb"
+  "spec/dummy/app/components/cached_thing_call_component.rb"
+  "spec/dummy/app/views/caching/_partial_render_partial.rbx"
+)
+for i in "${templates[@]}"
+do
+  mv $i $i.original
+  mv $i.changed $i
+done
+
+echo "Running subsequent caching specs to test cache-busting of warm cache..."
+
+bundle exec rspec spec/integration/caching/after_changes_spec.rb
+RESULT+=$?
+
+echo "Cleaning up..."
+
+for i in "${templates[@]}"
+do
+  mv $i $i.changed
+  mv $i.original $i
+done
+
+exit $RESULT

data/docker-compose.yml

@@ -2,6 +2,7 @@ version: '3'
 
 volumes:
   bundle:
+  bundle_ruby2:
 
 services:
   rbexy:
@@ -14,6 +15,14 @@ services:
       - $HOME/.gitconfig:/root/.gitconfig:ro
       - $HOME/.gem/credentials:/root/.gem/credentials
     working_dir: /app
+  rbexy_ruby2:
+    build:
+      context: .
+      dockerfile: Dockerfile-ruby2
+    volumes:
+      - .:/app
+      - bundle_ruby2:/usr/local/bundle
+    working_dir: /app
   dummy:
     image: rbexy
     volumes:

data/lib/rbexy.rb

@@ -1,6 +1,7 @@
 require "rbexy/version"
 require "active_support/inflector"
 require "active_support/concern"
+require "active_support/core_ext/enumerable"
 require "action_view/helpers/output_safety_helper"
 require "action_view/helpers/capture_helper"
 require "action_view/helpers/tag_helper"

data/lib/rbexy/component.rb

@@ -9,6 +9,14 @@ module Rbexy
       def to_s
         self
       end
+
+      def split(*args)
+        super.map { |s| TemplatePath.new(s) }
+      end
+
+      def gsub(*args)
+        super.tap { |s| break TemplatePath.new(s) }
+      end
     end
 
     class_attribute :component_file_location
@@ -78,8 +86,8 @@ module Rbexy
       raise error
     end
 
-    def method_missing(meth, *args, &block)
-      view_context.send(meth, *args, &block)
+    def method_missing(meth, *args, **kwargs, &block)
+      view_context.send(meth, *args, **kwargs, &block)
     end
 
     def respond_to_missing?(method_name, include_all)

data/lib/rbexy/nodes/abstract_node.rb

@@ -17,6 +17,7 @@ module Rbexy
         @compile_context = context
         children.each { |c| c.inject_compile_context(context) } if respond_to?(:children)
         members.each { |c| c.inject_compile_context(context) } if respond_to?(:members)
+        value.inject_compile_context(context) if respond_to?(:value)
       end
 
       def transform!
@@ -24,6 +25,7 @@ module Rbexy
         ast_transformer.transform(self, compile_context)
         children.each(&:transform!) if respond_to?(:children)
         members.each(&:transform!) if respond_to?(:members)
+        value.transform! if respond_to?(:value)
       end
 
       private

data/lib/rbexy/version.rb

@@ -1,3 +1,3 @@
 module Rbexy
-  VERSION = "2.0.0.beta8"
+  VERSION = "2.0.0.beta9"
 end

data/rbexy.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.summary       = "A Ruby template language inspired by JSX"
   spec.homepage      = "https://github.com/patbenatar/rbexy"
   spec.license       = "MIT"
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.7.0")
 
   spec.metadata["allowed_push_host"] = "https://rubygems.org"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rbexy
 version: !ruby/object:Gem::Version
-  version: 2.0.0.beta8
+  version: 2.0.0.beta9
 platform: ruby
 authors:
 - Nick Giancola
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-01-23 00:00:00.000000000 Z
+date: 2021-03-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -206,6 +206,7 @@ files:
 - ".travis.yml"
 - CODE_OF_CONDUCT.md
 - Dockerfile
+- Dockerfile-ruby2
 - Gemfile
 - Gemfile.lock
 - Guardfile
@@ -214,6 +215,7 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- bin/test
 - docker-compose.yml
 - lib/rbexy.rb
 - lib/rbexy/ast_transformer.rb
@@ -270,14 +272,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">"
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.2.3
 signing_key: 
 specification_version: 4
 summary: A Ruby template language inspired by JSX