arbo 1.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 22683720ac7119aad91909431b9da5c0a2214a29a4569f622705d77ab35f42f8
+  data.tar.gz: d9ac926299732b42e9d5efa7e787c8aa0f85df22204706adf929864817b2fe9a
+SHA512:
+  metadata.gz: e6d29c4b96fb79a42a8be2bebf2ff75a3e67f0ca6d924a7634b44d4fb1fa4abfe83651c74628eadfc0fd2e122b19f1e21248c5aa855753e9a1d70a0cfcabaa14
+  data.tar.gz: 2e9d2d4a5605465345ca1d38515d4c5f97afb010db6f78f59df507ac263b79f4969be81d1787b2d93c3f2eaa95ce5a7ff31c8256c06f478a597cd083c8c7db5e

data/.github/workflows/ci.yaml

@@ -0,0 +1,21 @@
+---
+
+name: ci
+
+on: [push]
+
+jobs:
+  test:
+    name: test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.7.2
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rake

data/.github/workflows/daily.yaml

@@ -0,0 +1,23 @@
+---
+
+name: ci
+
+on:
+  schedule:
+    - cron: '1 1 * * *'
+
+jobs:
+  test:
+    name: test
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v2
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.7.2
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rake

data/.gitignore

@@ -0,0 +1,11 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+benchmarks
+.rvmrc
+.ruby-version
+.ruby-gemset
+tags
+.DS_Store
+docs/_site

data/CHANGELOG.md

@@ -0,0 +1,95 @@
+# Changelog
+
+## 1.2.0 [☰](https://github.com/varyonic/arbo/compare/v1.1.0...v1.1.1)
+
+* Fix rendering `link_to` with a block in a arbre template. [#64][] by [@varyonic][]
+* Fix deprecation warning about single arity template handlers on Rails 6. [#110][] by [@aramvisser][]
+* Fix ruby 2.7 kwargs warnings. [#205][] by [@deivid-rodriguez][]
+* Support nested attribute hashes rendered as hyphenated attributes. [#451][] [@Ikariusrb][]
+
+* Implement `render_in` alternative to `to_s`. [#1][] by [@varyonic][]
+* Remove build_head and build_body from HTML::Document tag. [#2][] by [@varyonic][]
+
+## 1.1.1 [☰](https://github.com/activeadmin/arbre/compare/v1.1.0...v1.1.1)
+
+* Use mime-types 2.x for Ruby 1.9 by [@timoschilling][]
+* Verify Ruby 2.3 support. [#59][] by [@dlackty][] 
+
+## 1.1.0 [☰](https://github.com/activeadmin/arbre/compare/v1.0.3...v1.1.0)
+
+* Tag option `for` sets the attribute when value is a string or symbol [#49][] by [@ramontayag][]
+
+## 1.0.3 [☰](https://github.com/activeadmin/arbre/compare/v1.0.2...v1.0.3)
+
+* Performance improvements [#40][] by [@alexesDev][]
+* Added all void elements as self-closing tags [#39][] by [@OscarBarrett][]
+* Missing tags added [#36][] / [#39][] by [@dtaniwaki][] and [@OscarBarrett][]
+
+## 1.0.2 [☰](https://github.com/activeadmin/arbre/compare/v1.0.1...v1.0.2)
+
+* make `Element#inspect` behave correctly in Ruby 2.0 [#16][] by [@seanlinsley][]
+* prevent `Arbre::Element#flatten` infinite recursion [#32][] by [@seanlinsley][]
+* make `find_by_class` correctly find children by class [#33][] by [@kaapa][]
+
+## 1.0.1 [☰](https://github.com/activeadmin/arbre/compare/v1.0.0...v1.0.1)
+
+* Template handler converts to string to satisfy Rack::Lint [#6][] by [@jpmckinney][]
+* Fix to `Tag#add_class` when passing a string of classes to Tag build method
+  [#4][] by [@gregbell][]
+* Not longer uses the default separator [#7][] by [@LTe][]
+
+## 1.0.0 [☰](https://github.com/activeadmin/arbre/compare/v1.0.0.rc4...v1.0.0)
+
+* Added support for the use of `:for` with non Active Model objects
+
+## 1.0.0.rc4 [☰](https://github.com/activeadmin/arbre/compare/v1.0.0.rc3...v1.0.0.rc4)
+
+* Fix issue where user could call `symbolize_keys!` on a
+  HashWithIndifferentAccess which doesn't implement the method
+
+## 1.0.0.rc3 [☰](https://github.com/activeadmin/arbre/compare/v1.0.0.rc2...v1.0.0.rc3)
+
+* Implemented `Arbre::HTML::Tag#default_id_for_prefix`
+
+## 1.0.0.rc2 [☰](https://github.com/activeadmin/arbre/compare/v1.0.0.rc1...v1.0.0.rc2)
+
+* Fixed bug where Component's build methods were being rendered within the
+  parent context.
+
+## 1.0.0.rc1
+
+Initial release and extraction from Active Admin
+
+[#4]: https://github.com/activeadmin/arbre/issues/4
+[#6]: https://github.com/activeadmin/arbre/issues/6
+[#7]: https://github.com/activeadmin/arbre/issues/7
+[#16]: https://github.com/activeadmin/arbre/issues/16
+[#32]: https://github.com/activeadmin/arbre/issues/32
+[#33]: https://github.com/activeadmin/arbre/issues/33
+[#36]: https://github.com/activeadmin/arbre/issues/36
+[#39]: https://github.com/activeadmin/arbre/issues/39
+[#40]: https://github.com/activeadmin/arbre/issues/40
+[#49]: https://github.com/activeadmin/arbre/issues/49
+[#59]: https://github.com/activeadmin/arbre/issues/59
+[#64]: https://github.com/activeadmin/arbre/pull/64
+[#110]: https://github.com/activeadmin/arbre/pull/110
+[#205]: https://github.com/activeadmin/arbre/pull/205
+[#451]: https://github.com/activeadmin/arbre/pull/451
+
+[#1]: https://github.com/varyonic/arbo/pull/1
+[#2]: https://github.com/varyonic/arbo/pull/2
+
+[@aramvisser]: https://github.com/aramvisser
+[@deivid-rodriguez]: https://github.com/deivid-rodriguez
+[@LTe]: https://github.com/LTe
+[@OscarBarrett]: https://github.com/OscarBarrett
+[@alexesDev]: https://github.com/alexesDev
+[@dtaniwaki]: https://github.com/dtaniwaki
+[@gregbell]: https://github.com/gregbell
+[@Ikariusrb]: https://github.com/Ikariusrb
+[@jpmckinney]: https://github.com/jpmckinney
+[@kaapa]: https://github.com/kaapa
+[@ramontayag]: https://github.com/ramontayag
+[@seanlinsley]: https://github.com/seanlinsley
+[@timoschilling]: https://github.com/timoschilling
+[@varyonic]: https://github.com/varyonic

data/CONTRIBUTING.md

@@ -0,0 +1,3 @@
+## Contributing
+
+To test `bundle exec rake`

data/Gemfile

@@ -0,0 +1,17 @@
+source 'http://rubygems.org'
+
+gemspec
+
+gem 'mime-types', '~> 2.6', platforms: :ruby_19
+
+group :test do
+  gem 'rspec'
+  gem 'rack'
+end
+
+group :rails do
+  gem 'rails'
+  gem 'rspec-rails'
+  gem 'combustion'
+  gem 'capybara'
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Greg Bell
+
+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.

data/README.md

@@ -0,0 +1,29 @@
+# Arbo - HTML Views in Ruby
+
+[Arbo](https://github.com/varyonic/arbo) makes it easy to generate HTML directly in Ruby. This gem was forked from [Arbre](https://github.com/activeadmin/arbre),
+starting when the author stepped down from maintaining Active Admin in 2018.
+Google 'why fork open source' for relevant articles.
+
+[![Version         ][rubygems_badge]][rubygems]
+
+## Goals
+
+The purpose of Arbo is to support Varyonic's fork of ActiveAdmin.
+
+## Getting started
+
+* Check out [the docs][docs].
+
+## Need help?
+
+Please use [StackOverflow][stackoverflow] for help requests and how-to questions.
+
+Please open GitHub issues for bugs and enhancements only, not general help requests.
+Please search previous issues (and Google and StackOverflow) before creating a new issue.
+
+
+[rubygems_badge]: http://img.shields.io/gem/v/arbo.svg
+[rubygems]: https://rubygems.org/gems/arbo
+
+[docs]: https://varyonic.github.io/arbo/
+[stackoverflow]: http://stackoverflow.com/questions/tagged/arbo

data/Rakefile

@@ -0,0 +1,18 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec
+
+task :console do
+  require 'irb'
+  require 'irb/completion'
+
+  require 'pry'
+  require 'arbo'
+
+  ARGV.clear
+  IRB.start
+end

data/arbo.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "arbo/version"
+
+Gem::Specification.new do |s|
+  s.name        = "arbo"
+  s.version     = Arbo::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Piers Chambers"]
+  s.email       = ["piers@varyonic.com"]
+  s.homepage    = ""
+  s.summary     = %q{Forked from Greg Bell's 'Arbre', An Object Oriented DOM Tree in Ruby}
+  s.description = %q{Forked from Greg Bell's 'Arbre', An Object Oriented DOM Tree in Ruby}
+  s.license     = "MIT"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.required_ruby_version = '>= 2.5'
+
+  s.add_dependency("activesupport", ">= 3.0.0")
+  s.add_dependency("ruby2_keywords", ">= 0.0.2")
+end

data/docs/Gemfile

@@ -0,0 +1,2 @@
+gem 'github-pages'
+gem 'jekyll-redirect-from'

data/docs/_config.yml

@@ -0,0 +1,7 @@
+plugins:
+  - jekyll-redirect-from
+
+defaults:
+  -
+    values:
+      layout: "default"

data/docs/_includes/footer.html

@@ -0,0 +1,8 @@
+<p id="footer">
+<div class="left">
+    Copyright 2011 <a href="http://gregbell.ca/">Greg Bell</a> and <a href="http://www.versapay.com/">VersaPay</a>
+</div>
+<div class="right">
+    <a href="http://twitter.com/share" class="twitter-share-button">Tweet</a></p>
+</div>
+</p>

data/docs/_includes/google-analytics.html

@@ -0,0 +1,16 @@
+<script type="text/javascript">
+
+    var _gaq = _gaq || [];
+    _gaq.push(['_setAccount', 'UA-23306458-1']);
+    _gaq.push(['_trackPageview']);
+
+    (function () {
+        var ga = document.createElement('script');
+        ga.type = 'text/javascript';
+        ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0];
+        s.parentNode.insertBefore(ga, s);
+    })();
+
+</script>

data/docs/_includes/head.html

@@ -0,0 +1,7 @@
+<head>
+    <title>Arbo | HTML Views in Ruby</title>
+    <link href='//fonts.googleapis.com/css?family=Yanone+Kaffeesatz:extralight,light,regular,bold' rel='stylesheet' type='text/css'>
+    <link href='//fonts.googleapis.com/css?family=Droid+Sans+Mono' rel='stylesheet' type='text/css'>
+    <link href="{{ site.baseurl }}/stylesheets/main.css" media="screen" rel="stylesheet" type="text/css" />
+    <script src="//platform.twitter.com/widgets.js" type="text/javascript"></script>
+</head>

data/docs/_includes/toc.html

@@ -0,0 +1,12 @@
+<ol class='level-1'>
+    <li><a href='{{ site.baseurl }}'>Contents</a></li>
+    <ol class='level-2'>
+        <li><a href='{{ site.baseurl }}#introduction'>Introduction</a></li>
+        <li><a href='{{ site.baseurl }}#installation'>Installation</a></li>
+        <li><a href='{{ site.baseurl }}#tags'>Tags</a></li>
+        <li><a href='{{ site.baseurl }}#componenets'>Components</a></li>
+        <li><a href='{{ site.baseurl }}#contexts'>Contexts</a></li>
+        <!-- li><a href='{{ site.baseurl }}/documentation.html#layouts'>Layouts</a></li -->
+        <li><a href='{{ site.baseurl }}#background'>Background</a></li>
+    </ol>
+</ol>

data/docs/_includes/top-menu.html

@@ -0,0 +1,8 @@
+<div id="header">
+    <h1><a href="{{ site.baseurl }}/index.html"><span>Arbo</span></a></h1>
+
+    <div id="nav">
+        <!-- a href="{{ site.baseurl }}/documentation.html">Documentation</a -->
+        <a href="http://github.com/varyonic/arbo">Get the Code</a>
+    </div>
+</div>

data/docs/_layouts/default.html

@@ -0,0 +1,21 @@
+<!DOCTYPE html>
+<html lang="en">
+  {% include head.html %}
+  <body class="with-sidebar">
+    <div id="wrapper">
+      {% include top-menu.html %}
+      <div id="main-content">
+        <div class='toc'>
+          {% include toc.html %}
+        </div>
+        <div class='toc-content'>
+          <div class='docs-content'>
+            {{ content }}
+          </div>
+        </div>
+      </div>
+      {% include footer.html %}
+    </div>
+    {% include google-analytics.html %}
+  </body>
+</html>

data/docs/index.md

@@ -0,0 +1,106 @@
+---
+redirect_from: /docs/documentation.html
+---
+# Arbo
+HTML Views in Ruby
+
+### Introduction
+
+Arbo is a alternate template system for [Ruby on Rails Action View](http://guides.rubyonrails.org/action_view_overview.html).
+Arbo expresses HTML using a Ruby DSL, which makes it similar to the [Builder](https://github.com/tenderlove/builder) gem for XML.
+Arbo is a fork of Arbre, which was extracted from [Active Admin](https://activeadmin.info/).
+
+An example `index.html.arb`:
+
+```ruby
+html {
+  head {
+    title "Welcome page"
+  }
+  body {
+    para "Hello, world"
+  }
+}
+```
+
+The purpose of Arbo is to leave the view as Ruby objects as long as possible,
+which allows an object-oriented approach including inheritance, composition, and encapsulation.
+
+### Installation
+
+Add gem `arbo` to your `Gemfile` and `bundle install`.
+
+Arbo registers itself as a Rails template handler for files with an extension `.arb`.
+
+### Tags
+
+Arbo DSL is composed of HTML tags.  Tag attributes including `id` and HTML classes are passed as a hash parameter and the tag body is passed as a block. Most HTML5 tags are implemented, including `script`, `embed` and `video`.
+
+A special case is the paragraph tag, <p>, which is mapped to `para`.
+
+JavaScript can be included by using `script { raw ... }`
+
+To include text that is not immediately part of a tag use `text_node`.
+
+### Components
+
+Arbo DSL can be extended by defining new tags composed of other, simpler tags.
+This provides a simpler alternative to nesting partials.
+The recommended approach is to subclass Arbo::Component and implement a new builder method.
+
+The builder_method defines the method that will be called to build this component
+when using the DSL. The arguments passed into the builder_method will be passed 
+into the #build method for you.
+
+For example:
+
+```ruby
+class Panel < Arbo::Component
+  builder_method :panel
+
+  def build(title, attributes = {})
+    super(attributes)
+
+    h3(title, class: "panel-title")
+  end
+end
+```
+
+By default components are `div` tags with an HTML class corresponding to the component class name.  This can be overridden by redefining the `tag_name` method.
+
+Several examples of Arbo components are [included in Active Admin](https://activeadmin.info/12-arbo-components.html)
+
+### Contexts
+
+An [Arbo::Context](http://www.rubydoc.info/gems/arbo/Arbo/Context) is an object in which Arbo DSL is interpreted, providing a root for the Ruby DOM that can be [searched and manipulated](http://www.rubydoc.info/gems/arbo/Arbo/Element). A context is automatically provided when a `.arb` template or partial is loaded. Contexts can be used when developing or testing a component.  Contexts are rendered by calling to_s.
+
+```ruby
+html = Arbo::Context.new do
+  panel "Hello World", id: "my-panel" do
+    span "Inside the panel"
+    text_node "Plain text"
+  end
+end
+
+puts html.to_s # =>
+```
+
+```html
+<div class='panel' id="my-panel">
+  <h3 class='panel-title'>Hello World</h3>
+  <span>Inside the panel</span>
+  Plain text
+</div>
+```
+
+A context allows you to specify Rails template assigns, aka. 'locals' and helper methods. Templates loaded by Action View have access to all [Action View helper methods](http://guides.rubyonrails.org/action_view_overview.html#overview-of-helpers-provided-by-action-view)
+
+### Background
+
+Similar projects include:
+- [Markaby](http://markaby.github.io/), written by \_why the luck stiff.
+- [Erector](http://erector.github.io/), developed at PivotalLabs.
+- [Fortitude](https://github.com/ageweke/fortitude), developed at Scribd.
+- [Inesita](https://inesita.fazibear.me/) (Opal)
+- [html_builder](https://github.com/crystal-lang/html_builder) (Crystal)
+