handlebarsjs 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f82a12060506efbddff4c69305414c8ad24cbecf14a897eae1805b6ae40a7fa5
-  data.tar.gz: 7d4b3aef04fd506d04fdcee4bcdc3256b6835ac92f856a1e9644ec77ff0cf194
+  metadata.gz: a0f26d492757f3c0f1dc7f7740fcd41814108598f544f8dfc61f19a7ed1037f5
+  data.tar.gz: dad315a5813be563702486c471d45787754308bd156502dede96db18f9785c79
 SHA512:
-  metadata.gz: ed39a269924ab2d1794104373d6dbe38fd6ced1b77a32bf1982f5e7310f7929713b6005d3940ecbf57ea89db54d1709efca994f629ccf4c01f60c7ff6e2c0e36
-  data.tar.gz: 9c05a160e762f831cd667b8c4ac14e930eed9900507f66429ff25b9b6a71f1193fea05aa49bf43c9d9b8ccf8d3ed93ce97e21d01656b70410a96c3ba8c6652e0
+  metadata.gz: 5b59f9ca3cc48cfbbad1bc63c97e9f31ae210aaf8155df382d9ce0957d330a945c0022b739d3112960f597b0f13bbae3ddb45763eeac18c4881d163220e1f62e
+  data.tar.gz: a2ecd7df6ee243b9d37cf648c7df7465e6a79c6a7439b2217b8c9de6934d622aa277c850434dd0905df7bec341ed30e3a06f0c3dcb0866a6b492824b34e725a3

data/CHANGELOG.md

@@ -1,3 +1,18 @@
+## [0.13.1](https://github.com/klueless-io/handlebarsjs/compare/v0.13.0...v0.13.1) (2023-10-17)
+
+
+### Bug Fixes
+
+* update to use cmdlet 13.1 which fixes activesupport issue in 7.1.1 ([c5e438f](https://github.com/klueless-io/handlebarsjs/commit/c5e438f4e2d1727037694cae3f6bc8034bc5d4fe))
+
+# [0.13.0](https://github.com/klueless-io/handlebarsjs/compare/v0.12.0...v0.13.0) (2023-07-19)
+
+
+### Features
+
+* synchronise versions ([95789d5](https://github.com/klueless-io/handlebarsjs/commit/95789d5566d9df9e6e29b42715cf71a9fe4e36b7))
+* synchronise versions ([4cf212b](https://github.com/klueless-io/handlebarsjs/commit/4cf212bb1274bacf61e13a8491c20860e99193ea))
+
 # [0.12.0](https://github.com/klueless-io/handlebarsjs/compare/v0.11.3...v0.12.0) (2023-07-19)
 
 

data/Gemfile

@@ -14,15 +14,10 @@ group :development, :test do
   gem 'rubocop'
   gem 'rubocop-rake', require: false
   gem 'rubocop-rspec', require: false
-end
-
-group :test do
   gem 'simplecov', require: false
-end
 
-# If local dependency
-if ENV['KLUE_LOCAL_GEMS']&.to_s&.downcase == 'true'
-  group :development, :test do
+  # If local dependency
+  if ENV['KLUE_LOCAL_GEMS']&.to_s&.downcase == 'true'
     puts 'Using Local GEMs'
     gem 'cmdlet' , path: '../cmdlet'
   end

data/README.md

@@ -33,7 +33,7 @@ See [project plan](./docs/project-plan.md)
 
 ## Usage
 
-See all [usage examples](./USAGE.md)
+See all [usage examples](./docs/ussage.md)
 
 
 

data/docs/ussage.md

@@ -0,0 +1,384 @@
+# Handlebars and Ruby Helper Documentation Guide
+
+## Table of Contents
+1. [Introduction](#introduction)
+2. [Installation](#installation)
+3. [Configuration](#configuration)
+4. [Available Helpers](#available-helpers)
+   - [String Helpers](#string-helpers)
+   - [Array Helpers](#array-helpers)
+   - [Comparison Helpers](#comparison-helpers)
+   - [Inflection Helpers](#inflection-helpers)
+   - [Case Helpers](#case-helpers)
+   - [Miscellaneous Helpers](#miscellaneous-helpers)
+5. [Advanced Usage](#advanced-usage)
+6. [Troubleshooting](#troubleshooting)
+7. [Contributing](#contributing)
+
+## Introduction
+This guide provides an overview of the available helpers that can be used with Handlebars templates in combination with Ruby backends. These helpers simplify common operations like string transformations, array manipulations, and comparison logic to streamline template creation and data formatting.
+
+## Installation
+To use the helpers in your project, add the relevant gem to your `Gemfile` and install it:
+
+```ruby
+# Add this line to your Gemfile
+gem 'handlebarsjs'
+
+# Run bundle install to install the gem
+bundle install
+```
+
+## Configuration
+You can customize the helpers using a configuration block. Below is an example showing how to configure some settings for your helpers in Ruby:
+
+```ruby
+Handlebars.configure do |config|
+  config.helper_prefix = 'custom'
+  config.auto_escape = true
+  # Add other configuration options as needed
+end
+```
+
+To extend the configuration, you can also register the `HandlebarsConfigurationExtension`:
+
+```ruby
+KConfig::Configuration.register(:handlebars, Handlebarsjs::HandlebarsConfigurationExtension)
+```
+
+The `HandlebarsConfigurationDefaults` can be used to preload default helpers for each category:
+
+```ruby
+Handlebarsjs::HandlebarsConfigurationDefaults.new.add_all_defaults
+```
+
+This allows you to pre-configure helpers for arrays, strings, cases, comparisons, and other categories, providing a streamlined setup process for using helpers effectively.
+
+## Available Helpers
+
+### Miscellaneous Helpers
+
+#### Safe
+The `safe` helper allows you to output HTML or other special characters without escaping them. This is particularly useful when you want to retain tags or special symbols in your output.
+
+Usage:
+
+```handlebars
+{{safe value}}
+```
+
+**Example:**
+
+- Input: `<hello name="world" />`
+- Output: `<hello name="world" />`
+
+#### FormatJson
+The `format_json` helper is used to format a given value into pretty JSON, which is especially helpful for rendering JSON objects in a human-readable way.
+
+Usage:
+
+```handlebars
+{{format_json value}}
+```
+
+**Example:**
+
+- Input: `"<hello>World</hello>"`
+- Output: `"&quot;&lt;hello&gt;World&lt;/hello&gt;&quot;"`
+
+### Array Helpers
+
+#### JoinPost
+The `join_post` helper joins an array of elements into a single string with a separator, adding the separator at the end of the string.
+
+Usage:
+
+```handlebars
+{{join_post values}}
+```
+
+**Example:**
+
+- Input: `[1, 2, 3]`
+- Default Separator Output: `1,2,3,`
+- Custom Separator: `{{join_post values "|"}}` results in `1|2|3|`
+
+#### Join
+The `join` helper joins an array of elements into a single string with a separator.
+
+Usage:
+
+```handlebars
+{{join values}}
+```
+
+**Example:**
+
+- Input: `[1, 2, 3]`
+- Default Separator Output: `1,2,3`
+- Custom Separator: `{{join values "|"}}` results in `1|2|3`
+
+#### JoinPre
+The `join_pre` helper joins an array of elements into a single string with a separator, adding the separator at the beginning of the string.
+
+Usage:
+
+```handlebars
+{{join_pre values}}
+```
+
+**Example:**
+
+- Input: `[1, 2, 3]`
+- Default Separator Output: `,1,2,3`
+- Custom Separator: `{{join_pre values "|"}}` results in `|1|2|3`
+
+### Inflection Helpers
+
+#### Ordinal
+The `ordinal` helper adds the appropriate suffix to a number to denote its position in an ordered sequence.
+
+Usage:
+
+```handlebars
+{{ordinal value}}
+```
+
+**Example:**
+
+- Input: `1`
+- Output: `st`
+
+- Input: `2`
+- Output: `nd`
+
+#### Ordinalize
+The `ordinalize` helper converts a number to its ordinal representation.
+
+Usage:
+
+```handlebars
+{{ordinalize value}}
+```
+
+**Example:**
+
+- Input: `1`
+- Output: `1st`
+
+- Input: `2`
+- Output: `2nd`
+
+#### Singularize
+The `singularize` helper converts a word to its singular form.
+
+Usage:
+
+```handlebars
+{{singularize value}}
+```
+
+**Example:**
+
+- Input: `octopi`
+- Output: `octopus`
+
+#### Pluralize
+The `pluralize` helper converts a word to its plural form.
+
+Usage:
+
+```handlebars
+{{pluralize value}}
+```
+
+**Example:**
+
+- Input: `octopus`
+- Output: `octopi`
+
+### Case Helpers
+
+#### Lower
+The `lower` helper converts all characters in a string to lowercase.
+
+Usage:
+
+```handlebars
+{{lower value}}
+```
+
+**Example:**
+
+- Input: `THE quick BROWN fox`
+- Output: `the quick brown fox`
+
+#### Slash
+The `slash` helper converts spaces in a string to forward slashes.
+
+Usage:
+
+```handlebars
+{{slash value}}
+```
+
+**Example:**
+
+- Input: `the quick brown fox`
+- Output: `the/quick/brown/fox`
+
+#### Lamel
+The `lamel` helper converts a string to lower camel case.
+
+Usage:
+
+```handlebars
+{{lamel value}}
+```
+
+**Example:**
+
+- Input: `the quick brown fox`
+- Output: `theQuickBrownFox`
+
+### Comparison Helpers
+
+#### Lte
+The `lte` helper checks if one value is less than or equal to another.
+
+Usage:
+
+```handlebars
+{{#if (lte lhs rhs)}} ... {{/if}}
+```
+
+**Example:**
+
+- Input: `1 <= 2`
+- Output: `true`
+
+#### Eq
+The `eq` helper checks if two values are equal.
+
+Usage:
+
+```handlebars
+{{#if (eq lhs rhs)}} ... {{/if}}
+```
+
+**Example:**
+
+- Input: `'aaa' == 'aaa'`
+- Output: `true`
+
+### String Helpers
+
+#### Padl
+The `padl` helper adds padding to the left side of a string.
+
+Usage:
+
+```handlebars
+{{padl value count char}}
+```
+
+**Example:**
+
+- Input: `pad-me` with padding count of `10` and character `-`
+- Output: `----pad-me`
+
+#### Padr
+The `padr` helper adds padding to the right side of a string.
+
+Usage:
+
+```handlebars
+{{padr value count char}}
+```
+
+**Example:**
+
+- Input: `pad-me` with padding count of `10` and character `-`
+- Output: `pad-me----`
+
+## Advanced Usage
+For more advanced usage, such as creating custom helpers or extending functionality, you can use the `register_helper` method. Here’s an example to create a custom helper that returns the current date:
+
+```ruby
+handlebars.register_helper(:current_date) do |context|
+  Time.now.strftime("%Y-%m-%d")
+end
+```
+
+In Handlebars template:
+
+```handlebars
+<p>Today's Date: {{current_date}}</p>
+```
+
+## Troubleshooting
+If helpers are not behaving as expected, consider the following tips:
+
+- Ensure that all helpers are registered before compiling the template.
+- Verify the input data format matches the expected type for each helper.
+- Check for typos in the helper names used in the templates.
+
+## Contributing
+We welcome contributions to enhance the available helpers and documentation. Feel free to fork the repository and submit pull requests. Make sure to follow our contribution guidelines available in `CONTRIBUTING.md`.
+
+For any questions or issues, please create an issue on GitHub.
+
+## File Structure
+
+### lib
+
+#### handlebarsjs
+
+##### helpers
+
+###### misc
+- format_json.rb
+- safe.rb
+
+###### array
+- join_pre.rb
+- join.rb
+- join_post.rb
+
+###### inflection
+- singularize.rb
+- pluralize.rb
+- pluralize_number_word.rb
+- ordinal.rb
+- pluralize_number.rb
+- ordinalize.rb
+
+###### case
+- camel.rb
+- title.rb
+- back_slash.rb
+- dot.rb
+- constant.rb
+- lower.rb
+- snake.rb
+- dash.rb
+- human.rb
+- upper.rb
+- lamel.rb
+- slash.rb
+- double_colon.rb
+
+###### comparison
+- and.rb
+- default.rb
+- lt.rb
+- gte.rb
+- eq.rb
+- gt.rb
+- or.rb
+- ne.rb
+- lte.rb
+
+###### str
+- padl.rb
+- padr.rb

data/lib/handlebarsjs/handlebars_configuration_defaults.rb

@@ -66,7 +66,6 @@ module Handlebarsjs
     def add_misc_defaults
       KConfig.configure do |config|
         config.handlebars.helper(:format_json, Handlebarsjs::Helpers::Misc::FormatJson.new)
-        config.handlebars.helper(:omit, Handlebarsjs::Helpers::Misc::Omit.new, aliases: %i[ignore comment_out])
         config.handlebars.helper(:safe, Handlebarsjs::Helpers::Misc::Safe.new)
       end
     end

data/lib/handlebarsjs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Handlebarsjs
-  VERSION = '0.13.0'
+  VERSION = '0.14.0'
 end

data/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "handlebarsjs",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "handlebarsjs",
-      "version": "0.13.0",
+      "version": "0.14.0",
       "devDependencies": {
         "@klueless-js/semantic-release-rubygem": "github:klueless-js/semantic-release-rubygem",
         "@semantic-release/changelog": "^6.0.1",

data/package.json

@@ -1,6 +1,6 @@
 {
   "name": "handlebarsjs",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "handlebarsjs GEM wraps the handlebars.js library and provides ruby/javascript interoperability",
   "scripts": {
     "release": "semantic-release"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: handlebarsjs
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - David Cruwys
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-07-19 00:00:00.000000000 Z
+date: 2024-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cmdlet
@@ -88,6 +88,7 @@ files:
 - docs/domain_model_custom.drawio
 - docs/project-plan/project.drawio
 - docs/project-plan/project_in_progress.svg
+- docs/ussage.md
 - lib/_.rb
 - lib/handlebarsjs.rb
 - lib/handlebarsjs/base_helper.rb