easol-canvas 0.1.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 466969ef38180518fc021186d0c5fa694a3ddf947bae466c7cabed401fa44c1e
-  data.tar.gz: 2521767c9f3eff3944c4b897b503c14715d52abf6642e30f1d330403ea167d85
+  metadata.gz: 97ee44a992eb400c6fe2eedd35e6bb395ebc05e2f59f039ea9335194ff64fe83
+  data.tar.gz: 2684ff4ca3910fab9f0cd3bc36cb0c847f31565b1d3f8576964102a28773f247
 SHA512:
-  metadata.gz: 6b49d991c487acd1fe4bac1219a3c67d98b68ba56757ccd4fc7b7310f0532942bc1377431b1ec29e729ffff77d00cb6a63313e6cd07329080970720036b2f29f
-  data.tar.gz: 616a6b356396c5aee908a21449633508d1336ad695a6f5b0e690b276f1d1b8eade52cd0eb919329199d7cd661066f60fce6d2c3f8a1b1639094c5b3f00debad0
+  metadata.gz: 28c155af546e6898977757280894cba8ab26942aa1883c5b3ff752f3d7256b68c0631b9d18b6e29df8629d79e94a488739d2c9d0d1d1563dc8f4672f91d164ff
+  data.tar.gz: 3f743a067e8621d1b0893fe41afa8746b60dcc87a4398214b7d8b45ae66648088c22db84e2ed23b26df72c586f19b0547df3a6c8c354f36a005556262fef5a98

data/lib/canvas/check.rb

@@ -1,6 +1,9 @@
-require 'cli/ui'
+# frozen_string_literal: true
+
+require "cli/ui"
 
 module Canvas
+  # :documented:
   class Check
     attr_reader :offenses
 

data/lib/canvas/checks/required_files_check.rb

@@ -1,4 +1,7 @@
+# frozen_string_literal: true
+
 module Canvas
+  # :documented:
   class RequiredFilesCheck < Check
     REQUIRED_FILES = [
       "templates/product/index.{html,liquid}",

data/lib/canvas/checks/valid_block_schemas_check.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Canvas
+  # :documented:
+  # This check will validate the schema defined in the front matter
+  # within each block template file.
+  #
+  # Example of block Liquid with valid front matter:
+  #
+  # ---
+  # my_title:
+  #   type: string
+  # my_color:
+  #   type: color
+  #   label: My color
+  #   hint: "Select your favourite color"
+  # ---
+  #
+  # <p>My block HTML</p>
+  #
+  class ValidBlockSchemasCheck < Check
+    def run
+      custom_types = Canvas::FetchCustomTypes.call
+      block_files.each do |filename|
+        file = File.read(filename)
+        front_matter = extract_front_matter(file)
+        validate_format(filename, front_matter) &&
+          validate_schema(filename, front_matter, custom_types)
+      end
+    end
+
+    private
+
+    def block_files
+      Dir.glob("blocks/**/*.{html,liquid}")
+    end
+
+    def validate_format(filename, front_matter)
+      return true if front_matter.is_a?(Hash) &&
+                     front_matter.values.all? { |attr| attr.is_a?(Hash) }
+
+      @offenses << Offense.new(
+        message: "Invalid Block Schema: #{filename} - \nSchema is not in a valid format"
+      )
+      false
+    end
+
+    def validate_schema(filename, front_matter, custom_types)
+      schema = extract_schema(front_matter)
+      validator = Validator::BlockSchema.new(schema: schema, custom_types: custom_types)
+      return if validator.validate
+
+      validator.errors.each do |message|
+        @offenses << Offense.new(
+          message: "Invalid Block Schema: #{filename} - \n#{message}"
+        )
+      end
+    end
+
+    def extract_front_matter(file)
+      extractor = Canvas::FrontMatterExtractor.new(file)
+      front_matter = extractor.front_matter
+      front_matter.nil? ? {} : YAML.safe_load(front_matter)
+    end
+
+    def extract_schema(front_matter)
+      {
+        "attributes" => Canvas::ExpandAttributes.call(front_matter)
+      }
+    end
+  end
+end

data/lib/canvas/checks/valid_custom_types_check.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Canvas
+  # :documented:
+  # This check will validate the JSON objects that represent the
+  # custom types that are defined in the /types directory.
+  class ValidCustomTypesCheck < Check
+    def run
+      custom_type_files.each do |filename|
+        schema = extract_json(filename)
+        validator = Validator::CustomType.new(schema: schema)
+
+        next if validator.validate
+
+        validator.errors.each do |message|
+          @offenses << Offense.new(
+            message: "Invalid Custom Type: #{filename} - \n#{message}"
+          )
+        end
+      end
+    end
+
+    private
+
+    def custom_type_files
+      Dir.glob("types/*.json")
+    end
+
+    def extract_json(filename)
+      file = File.read(filename)
+      JSON.parse(file)
+    rescue JSON::ParserError
+      nil
+    end
+  end
+end

data/lib/canvas/checks/valid_footer_schema_check.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Canvas
+  # :documented:
+  # This check will validate the schema defined in the front matter
+  # within each footer template file.
+  #
+  # Example of footer Liquid with valid front matter:
+  #
+  # ---
+  # max_item_levels: 2
+  # supports_open_new_tab: true
+  # attributes:
+  #   my_title:
+  #     type: string
+  #   my_color:
+  #     type: color
+  #     label: My color
+  #     hint: "Select your favourite color"
+  # ---
+  #
+  # <p>My footer HTML</p>
+  #
+  class ValidFooterSchemaCheck < Check
+    def run
+      file = File.read(footer_filename)
+      front_matter = extract_front_matter(file)
+      validate_format(front_matter) &&
+        validate_schema(front_matter)
+    end
+
+    private
+
+    def footer_filename
+      Dir.glob("partials/footer/index.{html,liquid}").first
+    end
+
+    def validate_format(front_matter)
+      return true if front_matter.is_a?(Hash) && attributes_valid_format(front_matter)
+
+      @offenses << Offense.new(
+        message: "Invalid Footer Schema: #{footer_filename} - \nSchema is not in a valid format"
+      )
+      false
+    end
+
+    def attributes_valid_format(front_matter)
+      return true unless front_matter.key?("attributes")
+
+      front_matter["attributes"].is_a?(Hash) &&
+        front_matter["attributes"].values.all? { |attr| attr.is_a?(Hash) }
+    end
+
+    def validate_schema(front_matter)
+      schema = extract_schema(front_matter)
+      validator = Validator::FooterSchema.new(
+        schema: schema,
+        custom_types: Canvas::FetchCustomTypes.call
+      )
+      return if validator.validate
+
+      validator.errors.each do |message|
+        @offenses << Offense.new(
+          message: "Invalid Footer Schema: #{footer_filename} - \n#{message}"
+        )
+      end
+    end
+
+    def extract_front_matter(file)
+      extractor = Canvas::FrontMatterExtractor.new(file)
+      front_matter = extractor.front_matter
+      front_matter.nil? ? {} : YAML.safe_load(front_matter)
+    end
+
+    def extract_schema(front_matter)
+      front_matter.merge(
+        "attributes" => Canvas::ExpandAttributes.call(front_matter["attributes"])
+      )
+    end
+  end
+end

data/lib/canvas/checks/valid_html_check.rb

@@ -1,4 +1,7 @@
+# frozen_string_literal: true
+
 module Canvas
+  # :documented:
   class ValidHtmlCheck < Check
     def run
       html_files.each do |filename|

data/lib/canvas/checks/valid_json_check.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Canvas
+  # :documented:
+  class ValidJsonCheck < Check
+    def run
+      json_files.each do |filename|
+        file = File.read(filename)
+        validator = Validator::Json.new(file)
+
+        next if validator.validate
+
+        validator.errors.each do |message|
+          @offenses << Offense.new(
+            message: "Invalid JSON: #{filename} - \n#{message}"
+          )
+        end
+      end
+    end
+
+    private
+
+    def json_files
+      Dir.glob("**/*.json")
+    end
+  end
+end

data/lib/canvas/checks/valid_liquid_check.rb

@@ -1,4 +1,7 @@
+# frozen_string_literal: true
+
 module Canvas
+  # :documented:
   class ValidLiquidCheck < Check
     def run
       register_tags!
@@ -9,7 +12,7 @@ module Canvas
 
         next if validator.validate
 
-        validator.errors.map(&:message).each do |message|
+        validator.errors.each do |message|
           @offenses << Offense.new(
             message: "Invalid Liquid: #{filename} - \n#{message}"
           )

data/lib/canvas/checks/valid_menu_schema_check.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module Canvas
+  # :documented:
+  # This check will validate the schema defined in the front matter
+  # within each menu template file.
+  #
+  # Example of menu Liquid with valid front matter:
+  #
+  # ---
+  # max_item_levels: 2
+  # supports_open_new_tab: true
+  # attributes:
+  #   my_title:
+  #     type: string
+  #   my_color:
+  #     type: color
+  #     label: My color
+  #     hint: "Select your favourite color"
+  # ---
+  #
+  # <p>My menu HTML</p>
+  #
+  class ValidMenuSchemaCheck < Check
+    def run
+      file = File.read(menu_filename)
+      front_matter = extract_front_matter(file)
+      validate_format(front_matter) &&
+        validate_schema(front_matter)
+    end
+
+    private
+
+    def menu_filename
+      Dir.glob("partials/menu/index.{html,liquid}").first
+    end
+
+    def validate_format(front_matter)
+      return true if front_matter.is_a?(Hash) && attributes_valid_format(front_matter)
+
+      @offenses << Offense.new(
+        message: "Invalid Menu Schema: #{menu_filename} - \nSchema is not in a valid format"
+      )
+      false
+    end
+
+    def attributes_valid_format(front_matter)
+      return true unless front_matter.key?("attributes")
+
+      front_matter["attributes"].is_a?(Hash) &&
+        front_matter["attributes"].values.all? { |attr| attr.is_a?(Hash) }
+    end
+
+    def validate_schema(front_matter)
+      schema = extract_schema(front_matter)
+      validator = Validator::MenuSchema.new(
+        schema: schema,
+        custom_types: Canvas::FetchCustomTypes.call
+      )
+      return if validator.validate
+
+      validator.errors.each do |message|
+        @offenses << Offense.new(
+          message: "Invalid Menu Schema: #{menu_filename} - \n#{message}"
+        )
+      end
+    end
+
+    def extract_front_matter(file)
+      extractor = Canvas::FrontMatterExtractor.new(file)
+      front_matter = extractor.front_matter
+      front_matter.nil? ? {} : YAML.safe_load(front_matter)
+    end
+
+    def extract_schema(front_matter)
+      front_matter.merge(
+        "attributes" => Canvas::ExpandAttributes.call(front_matter["attributes"])
+      )
+    end
+  end
+end

data/lib/canvas/checks/valid_sass_check.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Canvas
+  # :documented:
+  #
+  # This check will find all files ending in .css, .scss or .sass
+  # and run them through the sass validator - {Canvas::Validator::Sass}.
+  class ValidSassCheck < Check
+    def run
+      sass_files.each do |filename|
+        file = File.read(filename)
+        validator = Validator::Sass.new(file)
+
+        next if validator.validate
+
+        validator.errors.each do |message|
+          @offenses << Offense.new(
+            message: "Invalid Sass: #{filename} - \n#{message}"
+          )
+        end
+      end
+    end
+
+    private
+
+    def sass_files
+      Dir.glob("**/*.{css,scss,sass}")
+    end
+  end
+end

data/lib/canvas/checks.rb

@@ -1,4 +1,7 @@
+# frozen_string_literal: true
+
 module Canvas
+  # :documented:
   class Checks
     class << self
       def registered
@@ -10,7 +13,7 @@ module Canvas
         return if @checks.include?(klass)
         @checks << klass
       end
-      
+
       def deregister_all!
         @checks = []
       end

data/lib/canvas/cli.rb

@@ -1,12 +1,21 @@
+# frozen_string_literal: true
+
 require "thor"
-require 'cli/ui'
+require "cli/ui"
 
 module Canvas
+  # :documented:
   class Cli < Thor
     desc "lint", "Prints a hello world message"
     def lint
       CLI::UI::StdoutRouter.enable
       Canvas::Lint.new.run
     end
+
+    map %w[--version -v] => :__print_version
+    desc "--version, -v", "print the version"
+    def __print_version
+      puts Canvas::VERSION
+    end
   end
 end

data/lib/canvas/constants.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# :documented:
+# This file is used to define globally accessible constants.
+module Canvas
+  module Constants
+    COLOR_PALETTE_VALUES = %w[
+      primary
+      secondary
+      body-bg
+      body-color
+    ].freeze
+
+    PRIMITIVE_TYPES = %w[
+      image
+      product
+      post
+      page
+      link
+      text
+      string
+      boolean
+      number
+      color
+      select
+      range
+      radio
+      variant
+    ].freeze
+  end
+end

data/lib/canvas/lint.rb

@@ -1,6 +1,9 @@
-require 'cli/ui'
+# frozen_string_literal: true
+
+require "cli/ui"
 
 module Canvas
+  #:documented:
   class Lint
     def run
       output_context = CLI::UI::SpinGroup.new(auto_debrief: false)
@@ -29,13 +32,13 @@ module Canvas
     end
 
     def debrief_message
-      CLI::UI::Frame.open('Failures', color: :red) do
+      CLI::UI::Frame.open("Failures", color: :red) do
         failed_checks = @checks.filter(&:failed?)
         failed_checks.map do |check|
           CLI::UI::Frame.open(check.class.name, color: :red) do
-            output = check.offenses.map do |offense|
+            output = check.offenses.map { |offense|
               CLI::UI.fmt "{{x}} #{offense.message}"
-            end
+            }
             puts output.join("\n")
           end
         end

data/lib/canvas/offense.rb

@@ -1,4 +1,7 @@
+# frozen_string_literal: true
+
 module Canvas
+  # :documented:
   class Offense
     attr_reader :message
 

data/lib/canvas/services/expand_attributes.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Canvas
+  # :documented:
+  # This service will convert the attributes from a hash, as they are defined in the front matter,
+  # into an array of hashes that the {Canvas::Validator::SchemaAttribute} class expects.
+  # e.g. the following front matter:
+  #
+  # my_title:
+  #   type: string
+  # my_color:
+  #   type: color
+  #
+  # will get converted to:
+  #
+  # [
+  #   {
+  #     "name" => "my_title",
+  #     "type" => "string"
+  #   },
+  #   {
+  #     "name" => "my_color",
+  #     "type" => "color"
+  #   }
+  # ]
+  #
+  class ExpandAttributes
+    class << self
+      # @param attributes_hash [Hash] hash of attributes pulled from front matter
+      # @return [Array<Hash>] array of hashes that represent each attribute
+      def call(attributes_hash)
+        return [] if attributes_hash.nil?
+
+        attributes_hash.each_with_object([]) do |(name, attribute_hash), attrs|
+          attrs << attribute_hash.merge("name" => name)
+        end
+      end
+    end
+  end
+end

data/lib/canvas/services/fetch_custom_types.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Canvas
+  # :documented:
+  # This service can be used to fetch the custom types from the /types directory.
+  class FetchCustomTypes
+    class << self
+      # @return [Array<Hash>] a list of all the custom types defined in the
+      # theme within the /types directory.
+      def call
+        filenames = Dir.glob("types/*.json")
+        filenames.map { |filename| extract_json(filename) }.compact
+      end
+
+      private
+
+      def extract_json(filename)
+        file = File.read(filename)
+        JSON.parse(file)
+      rescue JSON::ParserError
+        nil
+      end
+    end
+  end
+end

data/lib/canvas/services/front_matter_extractor.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 module Canvas
   # :documented:
   # This service can be used to extract front matter from a liquid string.

data/lib/canvas/validators/block_schema.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require "nokogiri"
+require "liquid"
+
+module Canvas
+  module Validator
+    # :documented:
+    # This class is used to validate a schema for a block.
+    # Example of a valid block schema:
+    # {
+    #   "attributes" => [
+    #     {
+    #       "name" => "my_title",
+    #       "type" => "string"
+    #     },
+    #     {
+    #       "name" => "my_color",
+    #       "type" => "color",
+    #       "label" => "My color",
+    #       "hint" => "Select your favourite color"
+    #     }
+    #   ]
+    # }
+    class BlockSchema
+      PERMITTED_KEYS = %w[attributes].freeze
+
+      attr_reader :errors, :schema
+
+      # @param schema [Hash] the schema to be validated
+      # @param custom_types [Array<Hash>] a list of custom types
+      def initialize(schema:, custom_types: [])
+        @schema = schema
+        @custom_types = custom_types
+        @errors = []
+      end
+
+      def validate
+        if ensure_valid_format
+          ensure_no_unrecognized_keys
+          ensure_attributes_are_valid
+        end
+
+        @errors.empty?
+      end
+
+      private
+
+      def ensure_valid_format
+        return true if schema.is_a?(Hash) &&
+                       (schema["attributes"].nil? || attributes_array_of_hashes?(schema))
+
+        @errors << "Schema is not in a valid format"
+        false
+      end
+
+      def ensure_no_unrecognized_keys
+        unrecognized_keys = schema.keys - PERMITTED_KEYS
+        return true if unrecognized_keys.empty?
+
+        @errors << "Unrecognized keys: #{unrecognized_keys.join(', ')}"
+        false
+      end
+
+      def ensure_attributes_are_valid
+        return true unless schema["attributes"]
+
+        schema["attributes"].each do |attribute_schema|
+          attr_validator = Validator::SchemaAttribute.new(
+            attribute: attribute_schema,
+            custom_types: @custom_types
+          )
+          next if attr_validator.validate
+
+          @errors << "Attribute \"#{attribute_schema['name']}\" is invalid "\
+                     "- #{attr_validator.errors.join(', ')}"
+        end
+      end
+
+      def attributes_array_of_hashes?(schema)
+        schema["attributes"].is_a?(Array) &&
+          schema["attributes"].all? { |attr| attr.is_a?(Hash) }
+      end
+    end
+  end
+end