glimmer-dsl-web 0.8.5 → 0.8.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 668fcf5e225fe3142f0d0b2784dbf7a74244a44ef846c08348cf13db3f1ab3fe
-  data.tar.gz: 5ee41130d7959651270b6809d366a30f211314633da5ed26563eaf9fb5b933a5
+  metadata.gz: 38be4742b6e4be32704d86bbe0db19af0259b3c56a1f039028ceadfeb7fa42f2
+  data.tar.gz: bbe4558de7ce49a1a20cd6abb6b837ef0e5e6853472db91145b6719414524b6f
 SHA512:
-  metadata.gz: e63143f70902c00b606f7004bea2e74fa703d1d9b540b158522813bfccf94da256a5b12d4c1019157e5c76148cd5ff3ff9f3dfd0f7e73a480fe57e15250ca206
-  data.tar.gz: 32e47e7e28ebd7d546be6577c6be01f55ae4b7ad2e2754a943ce9ed09b407556fa52f2931dc0661fbdcc14f87e7a5dbc2014050d1490212c42f89f882990796c
+  metadata.gz: 98dfb5213321451ac67ebe397e0d8663d27c49dfb9397b694994b74deca7b31fad351e7a9cc4d637fdabccfb1ce3d6620228c123b519e71480d58f944f571752
+  data.tar.gz: 63e7e036931c362ab49894f7f2222c87fb5d8cc398e0a5de8b1b0420e0a9631f4901f2b7d1a1c32555a0152caa804102fc932866f4e29d7ff722ec20a9d1c90a

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## 0.8.6
+
+- `Glimmer::Util::UrlBuilder` implementation to facilitate building URLs (with protocol scheme, host, path, query params, and fragment)
+
 ## 0.8.5
 
 - Update `Rails::ResourceService` to generate class resource name through correct underscored name (not just downcased)

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for Web 0.8.5 (Beta)
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for Web 0.8.6 (Beta)
 ## Ruby-in-the-Browser Web Frontend Framework
 ### The "Rails" of Frontend Frameworks!!! ([Fukuoka Award Winning](https://andymaleh.blogspot.com/2025/01/glimmer-dsl-for-web-wins-in-fukuoka.html))
 #### Finally, Ruby Developer Productivity, Happiness, and Fun in the Frontend!!!
@@ -1423,7 +1423,7 @@ rails new glimmer_app_server
 Add the following to `Gemfile`:
 
 ```
-gem 'glimmer-dsl-web', '~> 0.8.5'
+gem 'glimmer-dsl-web', '~> 0.8.6'
 ```
 
 Run:
@@ -1774,6 +1774,28 @@ Note that there are alternative ways of invoking the `Rails::ResourceService.upd
 - `Rails::ResourceService.update(update_resource_url: "/contacts/#{form_contact.id}.json", resource_attributes: {first_name: form_contact.first_name, ...}) { |response, resource, errors| ... }`
 - `Rails::ResourceService.update(update_resource_url: "/contacts/#{form_contact.id}.json", params: {contact: {first_name: form_contact.first_name, ...}}) { |response, resource, errors| ... }`
 
+### Glimmer::Util::UrlBuilder
+
+`Glimmer::Util::UrlBuilder` is a convenience class that facilitate building URLs (with protocol scheme, host, path, query params, and fragment)
+
+First, make sure to require the class file:
+```ruby
+require 'glimmer/util/url_builder'
+```
+
+Usage:
+```ruby
+Glimmer::Util::UrlBuilder.new.scheme('http').host('www.google.com').path('/results').param('q', 'sports').fragment('#yesterday').to_url
+# => 'http://www.google.com/results?q=sports#yesterday'
+```
+
+Or you can start from the URL of the current webpage, and amend the URL with extra params:
+```ruby
+# Current URL: http://www.google.com/results?q=sports
+Glimmer::Util::UrlBuilder.current.param('year', '2036').to_url
+# => 'http://www.google.com/results?q=sports&year=2036'
+```
+
 ## Supported Glimmer DSL Keywords
 
 [All HTML elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element), following the Ruby method name standard of lowercase and underscored names.

data/VERSION

@@ -1 +1 @@
-0.8.5
+0.8.6

data/glimmer-dsl-web.gemspec

@@ -2,11 +2,11 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: glimmer-dsl-web 0.8.5 ruby lib
+# stub: glimmer-dsl-web 0.8.6 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "glimmer-dsl-web".freeze
-  s.version = "0.8.5".freeze
+  s.version = "0.8.6".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -89,6 +89,7 @@ Gem::Specification.new do |s|
     "lib/glimmer/dsl/web/style_element_expression.rb",
     "lib/glimmer/helpers/glimmer_helper.rb",
     "lib/glimmer/util/proc_tracker.rb",
+    "lib/glimmer/util/url_builder.rb",
     "lib/glimmer/web.rb",
     "lib/glimmer/web/component.rb",
     "lib/glimmer/web/component/component_style_container.rb",
@@ -119,5 +120,7 @@ Gem::Specification.new do |s|
   s.add_development_dependency(%q<jeweler>.freeze, [">= 2.3.9".freeze, "< 3.0.0".freeze])
   s.add_development_dependency(%q<rdoc>.freeze, [">= 6.2.1".freeze, "< 7.0.0".freeze])
   s.add_development_dependency(%q<opal-rspec>.freeze, ["~> 0.8.0.alpha2".freeze])
+  s.add_development_dependency(%q<minitest>.freeze, ["~> 5.25.4".freeze])
+  s.add_development_dependency(%q<minitest-focus>.freeze, ["~> 1.4.1".freeze])
 end
 

data/lib/glimmer/util/url_builder.rb

@@ -0,0 +1,116 @@
+# Copyright (c) 2023-2026 Andy Maleh
+#
+# 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.
+
+# TODO consider extracting this class into its own Ruby gem
+require 'delegate'
+
+module Glimmer
+  module Util
+    class UrlBuilder
+      DEFAULT_SCHEME = 'https'
+      REGEXP_URL = /^(http|https)?(:\/\/)?(([^\/\:]+):?(\d+)?)?(\/[^?#]*)?(\?[^#]*)?(\#.+)?$/
+      
+      class << self
+        def current
+          new.url($$.document.location.href) if RUBY_ENGINE == 'opal'
+        end
+      end
+    
+      def initialize
+        @scheme = DEFAULT_SCHEME
+        @params = {}
+      end
+    
+      def scheme(value)
+        @scheme = value || DEFAULT_SCHEME
+        self
+      end
+      alias protocol scheme
+      
+      def host(value)
+        return self if value.nil?
+        
+        @host = value
+        @host.gsub('/', '')
+        self
+      end
+      
+      def port(value)
+        return self if value.nil?
+        
+        @port = value
+        self
+      end
+      
+      def path(value)
+        return self if value.nil?
+        
+        @path = value
+        @path = "/#{@path}" unless @path.start_with?('/')
+        self
+      end
+      
+      def param(name, value)
+        @params[name.to_s] = value
+        self
+      end
+      
+      def query(value)
+        return self if value.nil?
+        
+        value = value.sub('?', '') if value.start_with?('?')
+        value.split('&').each do |param_pair|
+          name, value = param_pair.split('=')
+          @params[name.to_s] = value
+        end
+        self
+      end
+      
+      def fragment(value)
+        return self if value.nil?
+        
+        @fragment = value
+        @fragment = "##{@fragment}" unless @fragment.start_with?('#')
+        self
+      end
+      
+      def url(value)
+        url_scheme, url_slashes, url_host_port, url_host, url_port, url_path, url_query, url_fragment = REGEXP_URL.match(value).to_a.drop(1)
+        scheme(url_scheme).host(url_host).port(url_port).path(url_path).query(url_query).fragment(url_fragment)
+      end
+      
+      def to_url
+        output = "#{@scheme}://#{@host}"
+        output += ":#{@port}" if @port
+        output += "#{@path}#{compute_query}#{@fragment}"
+        output
+      end
+      alias to_s to_url
+      alias build to_url
+      
+      def compute_query
+        computed_query = @params.map { |name, value| "#{name}=#{value}" }.join('&')
+        computed_query = "?#{computed_query}" unless computed_query.empty?
+        computed_query
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-web
 version: !ruby/object:Gem::Version
-  version: 0.8.5
+  version: 0.8.6
 platform: ruby
 authors:
 - Andy Maleh
@@ -235,6 +235,34 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.8.0.alpha2
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.25.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 5.25.4
+- !ruby/object:Gem::Dependency
+  name: minitest-focus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.4.1
 description: Glimmer DSL for Web (Ruby in the Browser Web Frontend Framework) enables
   building Web Frontends using Ruby in the Browser, as per Matz's recommendation in
   his RubyConf 2022 keynote speech to replace JavaScript with Ruby. It aims at providing
@@ -328,6 +356,7 @@ files:
 - lib/glimmer/dsl/web/style_element_expression.rb
 - lib/glimmer/helpers/glimmer_helper.rb
 - lib/glimmer/util/proc_tracker.rb
+- lib/glimmer/util/url_builder.rb
 - lib/glimmer/web.rb
 - lib/glimmer/web/component.rb
 - lib/glimmer/web/component/component_style_container.rb