ruby2html 1.5.3 → 1.5.5

data/README.md

@@ -1,318 +0,0 @@
-# Ruby2html 🔮✨
-
-Transform your view logic into elegant, semantic HTML with the power of pure Ruby! 🚀✨
-
-## 🌟 What is Ruby2html?
-
-Ruby2html is a magical gem that allows you to write your views in pure Ruby and automatically converts them into clean, well-formatted HTML. Say goodbye to messy ERB templates and hello to the full power of Ruby in your views! 🎉
-
-## 🚀 Installation
-
-Add this line to your application's Gemfile:
-
-
-```ruby
-gem 'ruby2html'
-```
-
-And then execute:
-
-    $ bundle install
-
-Or install it yourself as:
-
-    $ gem install ruby2html
-
-## 🎨 Usage
-
-### In your views
-
-File: `app/views/your_view.html.rb`
-
-```ruby
-div class: 'container' do
-  h1 'Welcome to Ruby2html! 🎉', class: 'main-title', 'data-controller': 'welcome'
-  link_to 'Home Sweet Home 🏠', root_path, class: 'btn btn-primary', 'data-turbo': false
-
-  @products.each do |product|
-    h2 class: 'item-title', id: "product-#{product[:id]}" do
-      product.title
-    end
-    p class: 'item-description' do
-      product.description
-    end
-  end
-end
-
-plain '<div>Inline html</div>'.html_safe
-
-render partial: 'shared/navbar'
-```
-
-### (Optional) Nicely Format the HTML for source inspection
-
-File: `config/environments/development.rb` or `config/environments/test.rb`
-```ruby
-config.middleware.use Ruby2html::HtmlBeautifierMiddleware
-```
-
-#### Or use your current .erb views
-
-### In your ApplicationController
-
-File: `app/controllers/application_controller.rb`
-
-```ruby
-# frozen_string_literal: true
-
-class ApplicationController < ActionController::Base
-  include Ruby2html::RailsHelper
-end
-```
-
-File: `app/views/your_view.html.erb`
-
-Replace your ERB with beautiful Ruby code:
-
-```erb
-<%=
-  html(self) do
-    h1 "Welcome to Ruby2html! 🎉", class: 'main-title', 'data-controller': 'welcome'
-    div id: 'content', class: 'container' do
-      link_to 'Home Sweet Home 🏠', root_path, class: 'btn btn-primary', 'data-turbo': false
-    end
-
-    @items.each do |item|
-      h2 class: 'item-title', id: "item-#{item[:id]}" do
-        item.title
-      end
-      p class: 'item-description' do
-        item.description
-      end
-    end
-
-    plain "<div>Inline html</div>".html_safe
-
-    render partial: 'shared/navbar'
-  end
-%>
-```
-
-### Benchmark
-
-```bash
-ruby 3.3.3 (2024-06-12 revision f1c7b6f435) +YJIT [x86_64-linux]
-Warming up --------------------------------------
-GET /benchmark/html (ERB)
-                         2.000 i/100ms
-GET /benchmark/ruby (Ruby2html)
-                         1.000 i/100ms
-Calculating -------------------------------------
-GET /benchmark/html (ERB)
-                         20.989 (±19.1%) i/s -    102.000 in   5.077353s
-GET /benchmark/ruby (Ruby2html)
-                         20.438 (±19.6%) i/s -     97.000 in   5.010249s
-
-Comparison:
-GET /benchmark/html (ERB):       21.0 i/s
-GET /benchmark/ruby (Ruby2html):       20.4 i/s - same-ish: difference falls within error
-```
-
-### With ViewComponents
-
-Ruby2html seamlessly integrates with ViewComponents, offering flexibility in how you define your component's HTML structure. You can use the `call` method with Ruby2html syntax, or stick with traditional `.erb` template files.
-
-File: `app/components/application_component.rb`
-
-```ruby
-# frozen_string_literal: true
-
-class ApplicationComponent < ViewComponent::Base
-  include Ruby2html::ComponentHelper
-end
-```
-
-#### Option 1: Using `call` method with Ruby2html
-
-File: `app/components/greeting_component.rb`
-
-```ruby
-# frozen_string_literal: true
-
-class GreetingComponent < ApplicationComponent
-  def initialize(name)
-    @name = name
-  end
-
-  def call
-    html do
-      h1 class: 'greeting', 'data-user': @name do
-        "Hello, #{@name}! 👋"
-      end
-      p class: 'welcome-message' do
-        'Welcome to the wonderful world of Ruby2html!'
-      end
-    end
-  end
-end
-```
-
-#### Option 2: Using traditional ERB template
-
-File: `app/components/farewell_component.rb`
-
-```ruby
-# frozen_string_literal: true
-
-class FarewellComponent < ApplicationComponent
-  def initialize(name)
-    @name = name
-  end
-end
-```
-
-File: `app/components/farewell_component.html.rb`
-
-```rb
-div class: 'farewell' do
-  h1 class: 'farewell-message' do
-    "Goodbye, #{@name}! 👋"
-  end
-  p class: 'farewell-text' do
-    'We hope to see you again soon!'
-  end
-end
-```
-
-This flexibility allows you to:
-- Use Ruby2html syntax for new components or when refactoring existing ones
-- Keep using familiar ERB templates where preferred
-- Mix and match approaches within your application as needed
-
-### More Component Examples
-
-File: `app/components/first_component.rb`
-
-```ruby
-# frozen_string_literal: true
-
-class FirstComponent < ApplicationComponent
-  def initialize
-    @item = 'Hello, World!'
-  end
-
-  def call
-    html do
-      h1 id: 'first-component-title' do
-        'first component'
-      end
-      div class: 'content-wrapper' do
-        h2 'A subheading'
-      end
-      p class: 'greeting-text', 'data-testid': 'greeting' do
-        @item
-      end
-    end
-  end
-end
-```
-
-File: `app/components/second_component.rb`
-
-```ruby
-# frozen_string_literal: true
-
-class SecondComponent < ApplicationComponent
-  def call
-    html do
-      h1 class: 'my-class', id: 'second-component-title', 'data-controller': 'second' do
-        'second component'
-      end
-      link_to 'Home', root_path, class: 'nav-link', 'data-turbo-frame': false
-    end
-  end
-end
-```
-
-## Without Rails
-```ruby
-renderer = Ruby2html::Render.new(nil) do # nil is the context, you can use self or any other object
-  html do
-    head do
-      title 'Ruby2html Example'
-    end
-    body do
-      h1 'Hello, World!'
-    end
-  end
-end
-
-puts renderer.render # => "<html><head><title>Ruby2html Example</title></head><body><h1>Hello, World!</h1></body></html>"
-```
-
-## 🐢 Gradual Adoption
-
-One of the best features of Ruby2html is that you don't need to rewrite all your views at once! You can adopt it gradually, mixing Ruby2html with your existing ERB templates. This allows for a smooth transition at your own pace.
-
-### Mixed usage example
-
-File: `app/views/your_mixed_view.html.erb`
-
-```erb
-<h1>Welcome to our gradually evolving page!</h1>
-
-<%= render partial: 'legacy_erb_partial' %>
-
-<%=
-  html(self) do
-    div class: 'ruby2html-section' do
-      h2 "This section is powered by Ruby2html!"
-      p "Isn't it beautiful? 😍"
-    end
-  end
-%>
-
-<%= render ModernComponent.new %>
-
-<footer>
-  <!-- More legacy ERB code -->
-</footer>
-```
-
-In this example, you can see how Ruby2html seamlessly integrates with existing ERB code. This approach allows you to:
-
-- Keep your existing ERB templates and partials
-- Gradually introduce Ruby2html in specific sections
-- Use Ruby2html in new components while maintaining older ones
-- Refactor your views at your own pace
-
-Remember, there's no rush! You can keep your `.erb` files and Ruby2html code side by side until you're ready to fully transition. This flexibility ensures that adopting Ruby2html won't disrupt your existing workflow or require a massive rewrite of your application. 🌈
-
-## 🛠 Development
-
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
-
-## 🤝 Contributing
-
-Bug reports and pull requests are welcome on GitHub at https://github.com/sebyx07/ruby2html. 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/sebyx07/ruby2html/blob/master/CODE_OF_CONDUCT.md).
-
-## 📜 License
-
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-
-## 🌈 Code of Conduct
-
-Everyone interacting in the Ruby2html project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/sebyx07/ruby2html/blob/master/CODE_OF_CONDUCT.md).
-
-## 🌟 Features
-
-- Write views in pure Ruby 💎
-- Seamless Rails integration 🛤️
-- ViewComponent support with flexible template options 🧩
-- Automatic HTML beautification 💅
-- Easy addition of custom attributes and data attributes 🏷️
-- Gradual adoption - mix with existing ERB templates 🐢
-- Improved readability and maintainability 📚
-- Full access to Ruby's power in your views 💪
-
-Start writing your views in Ruby today and experience the magic of Ruby2html! ✨🔮

data/Rakefile

@@ -1,8 +0,0 @@
-# frozen_string_literal: true
-
-# Add your own tasks in files placed in lib/tasks ending in .rake,
-# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
-
-require_relative 'config/application'
-
-Rails.application.load_tasks

data/app/assets/config/manifest.js

@@ -1,2 +0,0 @@
-//= link_tree ../images
-//= link_directory ../stylesheets .css

data/app/assets/stylesheets/application.css

@@ -1,15 +0,0 @@
-/*
- * This is a manifest file that'll be compiled into application.css, which will include all the files
- * listed below.
- *
- * Any CSS (and SCSS, if configured) file within this directory, lib/assets/stylesheets, or any plugin's
- * vendor/assets/stylesheets directory can be referenced here using a relative path.
- *
- * You're free to add application-wide styles to this file and they'll appear at the bottom of the
- * compiled file so the styles you add here take precedence over styles defined in any other CSS
- * files in this directory. Styles in this file should be added after the last require_* statement.
- * It is generally better to create a new file per style scope.
- *
- *= require_tree .
- *= require_self
- */

data/app/channels/application_cable/channel.rb

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-module ApplicationCable
-  class Channel < ActionCable::Channel::Base
-  end
-end

data/app/channels/application_cable/connection.rb

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-module ApplicationCable
-  class Connection < ActionCable::Connection::Base
-  end
-end

data/app/components/application_component.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-class ApplicationComponent < ViewComponent::Base
-  include Ruby2html::ComponentHelper
-end

data/app/components/first_component.html.rb

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-h1 'first component'
-
-div do
-  h2 'A subheading'
-end
-
-another_div
-
-p @item

data/app/components/first_component.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-class FirstComponent < ApplicationComponent
-  def initialize
-    @item = 'Hello, World!'
-  end
-
-  def another_div
-    div do
-      "Item value: #{@item}"
-    end
-
-    div class: 'another' do
-      h2 'Another subheading from component'
-    end
-
-    h1 'Yet Another heading from component'
-  end
-end

data/app/components/second_component.rb

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-class SecondComponent < ApplicationComponent
-  def call
-    html do
-      h1 class: 'my-class' do
-        plain 'Second Component'
-      end
-      link_to 'Home', root_path
-    end
-  end
-end

data/app/components/third_component/third_component.html.rb

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-h1 'Third component'
-div do
-  "Item value: #{@item}"
-end

data/app/components/third_component.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-class ThirdComponent < ApplicationComponent
-  def initialize
-    @item = 'Hello, World!'
-  end
-end

data/app/controllers/application_controller.rb

@@ -1,7 +0,0 @@
-# frozen_string_literal: true
-
-class ApplicationController < ActionController::Base
-  # Only allow modern browsers supporting webp images, web push, badges, import maps, CSS nesting, and CSS :has.
-  allow_browser versions: :modern
-  include Ruby2html::RailsHelper
-end

data/app/controllers/benchmark_controller.rb

@@ -1,48 +0,0 @@
-# frozen_string_literal: true
-
-class BenchmarkController < ApplicationController
-  def normal_html
-    @complex_data = generate_complex_data
-  end
-
-  def ruby_2html
-    @complex_data = generate_complex_data
-  end
-
-  private
-    def generate_complex_data
-      {
-        users: 50.times.map do |i|
-          {
-            id: i + 1,
-            name: Faker::Name.name,
-            email: Faker::Internet.email,
-            address: {
-              street: Faker::Address.street_address,
-              city: Faker::Address.city,
-              country: Faker::Address.country
-            },
-            orders: rand(1..5).times.map do
-              {
-                id: Faker::Alphanumeric.alphanumeric(number: 10),
-                total: Faker::Commerce.price(range: 10..1000.0),
-                items: rand(1..10).times.map do
-                  {
-                    name: Faker::Commerce.product_name,
-                    price: Faker::Commerce.price(range: 5..500.0),
-                    quantity: rand(1..5)
-                  }
-                end
-              }
-            end
-          }
-        end,
-        stats: {
-          total_users: 50,
-          average_orders_per_user: rand(1.0..5.0).round(2),
-          most_expensive_item: Faker::Commerce.product_name,
-          most_popular_country: Faker::Address.country
-        }
-      }
-    end
-end

data/app/controllers/home_controller.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-class HomeController < ApplicationController
-  def index
-    @items = [
-      {
-        title: 'Item 1',
-        description: 'Description 1'
-      }
-    ]
-  end
-
-  def rb_files
-    @value = 'value'
-  end
-end

data/app/helpers/application_helper.rb

@@ -1,4 +0,0 @@
-# frozen_string_literal: true
-
-module ApplicationHelper
-end

data/app/jobs/application_job.rb

@@ -1,9 +0,0 @@
-# frozen_string_literal: true
-
-class ApplicationJob < ActiveJob::Base
-  # Automatically retry jobs that encountered a deadlock
-  # retry_on ActiveRecord::Deadlocked
-
-  # Most jobs are safe to ignore if the underlying records are no longer available
-  # discard_on ActiveJob::DeserializationError
-end

data/app/mailers/application_mailer.rb

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-class ApplicationMailer < ActionMailer::Base
-  default from: 'from@example.com'
-  layout 'mailer'
-end

data/app/models/application_record.rb

@@ -1,5 +0,0 @@
-# frozen_string_literal: true
-
-class ApplicationRecord < ActiveRecord::Base
-  primary_abstract_class
-end

data/app/views/benchmark/normal_html.html.erb

@@ -1,31 +0,0 @@
-<h1>Benchmark: Normal HTML (ERB)</h1>
-
-<h2>User Statistics</h2>
-<ul>
-  <li>Total Users: <%= @complex_data[:stats][:total_users] %></li>
-  <li>Average Orders per User: <%= @complex_data[:stats][:average_orders_per_user] %></li>
-  <li>Most Expensive Item: <%= @complex_data[:stats][:most_expensive_item] %></li>
-  <li>Most Popular Country: <%= @complex_data[:stats][:most_popular_country] %></li>
-</ul>
-
-<h2>User List</h2>
-<% @complex_data[:users].each do |user| %>
-  <div class="user-card">
-    <h3><%= user[:name] %></h3>
-    <p>Email: <%= user[:email] %></p>
-    <p>Address: <%= "#{user[:address][:street]}, #{user[:address][:city]}, #{user[:address][:country]}" %></p>
-
-    <h4>Orders</h4>
-    <% user[:orders].each do |order| %>
-      <div class="order">
-        <p>Order ID: <%= order[:id] %></p>
-        <p>Total: $<%= order[:total] %></p>
-        <ul>
-          <% order[:items].each do |item| %>
-            <li><%= item[:name] %> - $<%= item[:price] %> (Quantity: <%= item[:quantity] %>)</li>
-          <% end %>
-        </ul>
-      </div>
-    <% end %>
-  </div>
-<% end %>

data/app/views/benchmark/ruby_2html.html.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-h1 'Benchmark: Ruby2html'
-
-h2 'User Statistics'
-ul do
-  li { plain "Total Users: #{@complex_data[:stats][:total_users]}" }
-  li { plain "Average Orders per User: #{@complex_data[:stats][:average_orders_per_user]}" }
-  li { plain "Most Expensive Item: #{@complex_data[:stats][:most_expensive_item]}" }
-  li { plain "Most Popular Country: #{@complex_data[:stats][:most_popular_country]}" }
-end
-
-h2 'User List'
-@complex_data[:users].each do |user|
-  div class: 'user-card' do
-    h3 user[:name]
-    p { plain "Email: #{user[:email]}" }
-    p { plain "Address: #{user[:address][:street]}, #{user[:address][:city]}, #{user[:address][:country]}" }
-
-    h4 'Orders'
-    user[:orders].each do |order|
-      div class: 'order' do
-        p { plain "Order ID: #{order[:id]}" }
-        p { plain "Total: $#{order[:total]}" }
-        ul do
-          order[:items].each do |item|
-            li { plain "#{item[:name]} - $#{item[:price]} (Quantity: #{item[:quantity]})" }
-          end
-        end
-      end
-    end
-  end
-end

data/app/views/home/form.html.rb

@@ -1,14 +0,0 @@
-# frozen_string_literal: true
-
-div do
-  h1 'form'
-
-  form_with url: '/form', method: 'post' do |f|
-    f.label :name
-    f.text_field :name
-    f.submit 'submit'
-  end
-
-  link_to 'Home', root_path
-  # button_to 'home', '/'
-end

data/app/views/home/index.html.erb

@@ -1,43 +0,0 @@
-<h1>Home</h1>
-
-<%= render FirstComponent.new %>
-<%= render SecondComponent.new %>
-<%= render ThirdComponent.new %>
-
-<%=
-  html(self) do
-    h1(id: 4) { "Inside" }
-    h2 "Inside 2", id: '44'
-    h1 "ok"
-    h1 "ok"
-    h1 "ok"
-    h1 "ok"
-    h1 "ok"
-    div do
-      link_to 'home 1', root_path
-    end
-    link_to 'home 2', root_path
-
-    div do
-      link_to 'home 3', root_path
-    end
-
-    render partial: 'shared/navbar'
-
-    @items.each do |item|
-      h1 item[:title]
-    end
-  end
-%>
-
-<%= render partial: 'shared/navbar' %>
-
-<%=
-  html(self) do
-    @items.each do |item|
-      h1 item[:title]
-    end
-
-    turbo_frame id: '4'
-  end
-%>