rails_age 0.4.1 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 03e419984be6f29b1da74d0de6e31ccb218ba966e3818537884fcff715024e02
-  data.tar.gz: cb5a30c1e17ee7bf30394691232e3185e317ef5e827ece3ab02ef7d14cb0aef5
+  metadata.gz: d54712ca67a303ffa92d78165d30a500b1f695be6176b3198e7ff3f9f60ab4f9
+  data.tar.gz: 8f8f999c42777dc432bf543b6256852d10a0fbcbcd4fe33ad06817277a47bb5d
 SHA512:
-  metadata.gz: 555b80c544a8d5217d5c40ef3f24c15cd8fbf0c13bf96d1445845d9afc21d5e2ab835a60ac678ba5177fa5562ef1b87d7f293226783c94f1470d8b64e7a56fd9
-  data.tar.gz: 303f2776ebc5320711f50ec54e9a136ba7d9727fcb28c8d0038ffdcb0edb94d6715b93f40598a70d3eb3b8f1405a05610a707458f91209288414f0a4a7251374
+  metadata.gz: 75c804a5b29705a18344ea70d9a799ea3578d90055b056ba48b70984132f2fbd04bdd906ac744e2a587fe095e9a8e112d773ecc84cf6325be192c212d769090d
+  data.tar.gz: 932a6c5843243a23ef48b69e87f0fef940030c9e47ce652be141bc6efb45a8cbde04c191853b3d15e754e3ee71d7033b301ab6432982c1fc357250fceb892f02

data/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-## VERSION 0.5.1 - 2024-xx-xx
+## VERSION 0.6.2 - 2024-xx-xx
 
 - **cypher queries** (like active record queries)
   * schema override
@@ -8,32 +8,49 @@
   * paths support
   * select attributes support
 
-## VERSION 0.5.0 - 2024-xx-xx
+## VERSION 0.6.1 - 2024-xx-xx
 
 - **Age Path**
 
-## VERSION 0.4.3 - 2024-xx-xx
+## VERSION 0.6.0 - 2024-xx-xx
+
+breaking change?: namespaces (by default) will use their own schema? (add to database.yml & schema.rb ?)
 
 - **AGE Schema override**
 
 - **multiple AGE Schema**
 
-## VERSION 0.4.3 - 2024-xx-xx
+## VERSION 0.5.3 - 2024-xx-xx
 
 - **Edge Scaffold** (generates edge, type, view and controller)
   * add `rails generate apache_age:edge_scaffold HasJob employee_role start_node:person end_node:company`
 
-## VERSION 0.4.2 - 2024-xx-xx
+## VERSION 0.5.2 - 2024-xx-xx
+
+- **Edge Generator**
+  * add start-/end-nodes types to edge generator (would make scaffold easier), ie:
+    `rails generate apache_age:edge HasPet owner_role start_node:person end_node:pet`
+    with property and specified start-/end-nodes (person and pet nodes must have already been created)
+
+## VERSION 0.5.2 - 2024-06-16
+
+- **Node Scaffold** (generates node, type, view and controller)
+  * add `rails generate apache_age:node_scaffold Person first_name last_name age:integer`
+
+## VERSION 0.5.1 - 2024-06-16
+
+**yanked** (2024-06-16) - had an issue with the generator
 
 - **Node Scaffold** (generates node, type, view and controller)
   * add `rails generate apache_age:node_scaffold Person first_name last_name age:integer`
 
-## VERSION 0.4.2 - 2024-xx-xx
+## VERSION 0.5.0 - 2024-06-15
+
+**breaking change**: renamed the validators to UniqueVertex and UniqueEdge
 
 - **Edge Generator**
-  * add `rails generate apache_age:edge HasPet owner_role` just a property
-  * add `rails generate apache_age:edge HasPet owner_role start_node:person end_node:pet`
-        with property and specified start-/end-nodes (person and pet nodes must have already been created)
+  * add `rails generate apache_age:edge HasPet owner_role`
+    caveate: start_node and end_node are of type `:vertex` in the generator but can be changed manually in the class file - having trouble with the generator loading the types (the generator rejects custom types - but rails still works with custom types)
 
 ## VERSION 0.4.1 - 2024-06-15
 
@@ -43,7 +60,7 @@
 
 ## VERSION 0.4.0 - 2024-06-14
 
-Minor breaking change: type (:vertix) is now required in core for edges
+**breaking change**: type (:vertix) is now required in core for edges
 
 - **Installer**
   * AGE types added to installer (with tests)

data/README.md

@@ -55,8 +55,11 @@ install Apache Age (you can ignore the `unknown OID` warnings)
 bundle add rails_age
 bundle install
 bin/rails apache_age:install
+# optional: prevents `bin/rails db:migrate` from modifying the schema file,
+# alternatively you can use: `bin/rails apache_age:migrate` to run safe migrations
+bin/rails apache_age:override_db_migrate
 git add .
-git commit -m "Add Apache Age to Rails"
+git commit -m "Add & configure Apache Age within Rails"
 ```
 
 make some nodes :string is the default type
@@ -69,10 +72,10 @@ make some edges (`:vertex` is the default type) for start_node and end_node
 ```bash
 # when start node and end node are not specified they are of type `:vertex`
 # this is generally not recommended - exept when very generic relationships are needed
-rails generate apache_age:edge HasJob employee_role
+rails generate apache_age:edge HasJob employee_role begin_date:date
 
-# this is recommended - use explicit start_node and end_node types
-rails generate apache_age:node HasPet start_node:person end_node:pet caretaker_role
+# # this is recommended - (but not yet working) add explicit start_node and end_node types manually
+# rails generate apache_age:node HasPet start_node:person end_node:pet caretaker_role
 ```
 
 **NOTE:** the default `rails db:migrate` inappropriately modifies the schema file. This installer patches the migration to prevent this (however this might break on rails updates, etc). **You can run `bin/rails apache_age:install` at any time to repair the schema file as needed.**

data/lib/apache_age/validators/{unique_edge_validator.rb → unique_edge.rb}

@@ -1,10 +1,14 @@
+# lib/apache_age/validators/unique_edge.rb
+
 # Usage (within an Age Model)
-# validates_with UniqueEdgeValidator, attributes: [:employee_role, :start_node, :end_node]
-# validates_with UniqueEdgeValidator, attributes: [:start_id, :employee_role, :end_id]
-#
+# validates_with(
+#   ApacheAge::Validators::UniqueEdge,
+#   attributes: [:start_id, :employee_role, :end_id]
+# )
+
 module ApacheAge
   module Validators
-    class UniqueEdgeValidator < ActiveModel::Validator
+    class UniqueEdge < ActiveModel::Validator
       def validate(record)
         allowed_keys = record.age_properties.keys
         attributes = options[:attributes] || []

data/lib/apache_age/validators/{unique_vertex_validator.rb → unique_vertex.rb}

@@ -1,10 +1,14 @@
+# lib/apache_age/validators/unique_vertex.rb
+
 # Usage (within an Age Model)
-# validates_with UniqueVertexValidator, attributes: [:first_name, :last_name, :gender]
+# validates_with(
+#   ApacheAge::Validators::UniqueVertex,
+#   attributes: [:first_name, :last_name, :gender]
+# )
 
-# lib/apache_age/validators/unique_vertex_validator.rb
 module ApacheAge
   module Validators
-    class UniqueVertexValidator < ActiveModel::Validator
+    class UniqueVertex < ActiveModel::Validator
       def validate(record)
         allowed_keys = record.age_properties.keys
         attributes = options[:attributes]

data/lib/generators/apache_age/edge/USAGE

@@ -1,35 +1,38 @@
 Description:
-    This creates Apache AGE nodes that work seamlessly with Rails.
-    A node can be created with or without a namespace.
+    This creates Apache AGE edges that work seamlessly with Rails.
+    An edge can be created with or without a namespace.
     See the below examples.
 
 Example:
-    `bin/rails g apache_age:node Cat name age:integer`
+    `bin/rails g apache_age:edge HasJob employee_role start_date:date`
+
+    (hopefully comming soon - but not yet ready is the ability to add start_node and end_node types)
+    `bin/rails g apache_age:edge HasJob employee_role start_date:date start_node:person end_node:company`
 
     This creates:
-        `app/nodes/cat.rb`
+        `app/edges/has_job.rb`
 
     with the contents:
         ```
-        class Cat
-          include ApacheAge::Entities::Vertex
+        class HasJob
+          include ApacheAge::Entities::Edge
 
-          attribute :name, :string
-          attribute :age, :integer
+          attribute :employee_role, :string
+          attribute :start_date, :date
 
-          validates :name, presence: true
-          validates :age, presence: true
+          validates :employee_role, presence: true
+          validates :begin_date, presence: true
 
           # unique node validator (remove any attributes that are not important to uniqueness)
           validates_with(
-            ApacheAge::Validators::UniqueVertexValidator,
-            attributes: [:name, :age]
+            ApacheAge::Validators::UniqueVertex,
+            attributes: [:employee_role, :begin_date :start_node, :end_node]
           )
         end
         ```
 
     A namespace can also be used:
-        `bin/rails g apache_age:node Animals/Cat name age:integer`
+        `bin/rails g apache_age:edge Animals/Cat name age:integer`
 
     This creates:
         `app/nodes/animals/cat.rb`
@@ -47,8 +50,8 @@ Example:
 
           # unique node validator (remove any attributes that are not important to uniqueness)
           validates_with(
-            ApacheAge::Validators::UniqueVertexValidator,
-            attributes: [:name, :age]
+            ApacheAge::Validators::UniqueVertex,
+            attributes: [:name, :age, :start_node, :end_node]
           )
         end
         ```

data/lib/generators/apache_age/edge/edge_generator.rb

@@ -1,56 +1,29 @@
+# lib/generators/apache_age/edge/edge_generator.rb
 require 'rails/generators'
 require 'rails/generators/named_base'
 
+require_relative '../generator_entity_helpers'
+# TODO: get generators to work with custom types!
+# require_relative "#{Rails.root}/config/initializers/types"
+
 module ApacheAge
   class EdgeGenerator < Rails::Generators::NamedBase
+    include ApacheAge::GeneratorEntityHelpers
+
+    desc "Generates edge (model) with attributes."
+
     source_root File.expand_path('templates', __dir__)
     argument :attributes, type: :array, default: [], banner: "field:type field:type"
 
     def perform_task
-      behavior == :invoke ? create_edge_file : destroy_edge_file
+      age_type = 'edge'
+      Rails.application.eager_load! # Ensure all initializers and dependencies are loaded
+      behavior == :invoke ? generate_age_entity(age_type) : destroy_age_entity(age_type)
     end
 
     private
 
-    def create_edge_file
-      template "edge.rb.tt", File.join("app/edge", class_path, "#{file_name}.rb")
-    end
-
-    def destroy_edge_file
-      file_path = File.join("app/edge", class_path, "#{file_name}.rb")
-      File.delete(file_path) if File.exist?(file_path)
-    end
-
-    def attributes_list
-      attributes.map { |attr| { name: attr.name, type: attr.type } }
-    end
-
-    def unique_attributes
-      attributes_list.map { |attr| attr[:name].to_sym }
-    end
-
-    def parent_module
-      class_path.map(&:camelize).join('::')
-    end
-
-    def full_class_name
-      parent_module.empty? ? class_name : "#{parent_module}::#{class_name}"
-    end
-
-    def indented_namespace
-      return '' if parent_module.empty?
-
-      parent_module.split('::').map.with_index do |namespace, index|
-        "#{'  ' * index}module #{namespace}"
-      end.join("\n") + "\n"
-    end
-
-    def indented_end_namespace
-      return '' if parent_module.empty?
-
-      parent_module.split('::').map.with_index do |_, index|
-        "#{'  ' * (parent_module.split('::').length - 1 - index)}end"
-      end.join("\n") + "\n"
-    end
+    # different than node_generator.rb
+    def unique_edge_attributes = unique_attributes + [:start_node, :end_node]
   end
 end

data/lib/generators/apache_age/edge/templates/edge.rb.tt

@@ -1,20 +1,28 @@
-<%= indented_namespace %>
-<%= '  ' * class_path.length %>class <%= class_name %>
-<%= '  ' * class_path.length %>  include ApacheAge::Entities::Edge
+class <%= class_name %>
+  include ApacheAge::Entities::Edge
 
 <%- attributes_list.each do |attribute| -%>
-<%= '  ' * class_path.length %>  attribute :<%= attribute[:name] %>, :<%= attribute[:reference] || attribute[:type] %>
+  attribute :<%= attribute[:name] %>, :<%= attribute[:reference] || attribute[:type] %>
 <%- end -%>
+  # recommendation for (start_node and end_node): change `:vertex` with the 'node' type
+  # see `config/initializers/apache_age.rb` for the list of available node types
+  attribute :start_node, :vertex
+  attribute :end_node, :vertex
 
-<%= '  ' * class_path.length %>  validates :<%= unique_attributes.first %>, presence: true
-<%= '  ' * class_path.length %>  validate :validate_unique
+<%- attributes_list.each do |attribute| -%>
+  validates :<%= attribute[:name] %>, presence: true
+<%- end -%>
+  validates :start_node, presence: true
+  validates :end_node, presence: true
+
+  validate :validate_unique_edge
 
-<%= '  ' * class_path.length %>  private
+  private
 
-<%= '  ' * class_path.length %>  def validate_unique
-<%= '  ' * class_path.length %>    ApacheAge::Validators::UniqueEdgeValidator
-<%= '  ' * class_path.length %>      .new(attributes: <%= unique_attributes.inspect %>)
-<%= '  ' * class_path.length %>      .validate(self)
-<%= '  ' * class_path.length %>  end
-<%= '  ' * class_path.length %>end
-<%= indented_end_namespace %>
+  # custom unique edge validator (remove any attributes that are NOT important to uniqueness)
+  def validate_unique_edge
+    ApacheAge::Validators::UniqueEdge
+      .new(attributes: <%= unique_edge_attributes.inspect %>)
+      .validate(self)
+  end
+end

data/lib/generators/apache_age/generator_entity_helpers.rb

@@ -0,0 +1,84 @@
+# lib/generators/apache_age/generator_entity_helpers.rb
+
+module ApacheAge
+  module GeneratorEntityHelpers
+    def generate_age_entity(age_type)
+      template "#{age_type}.rb.tt", File.join(destination_root, "app/#{age_type}s", class_path, "#{file_name}.rb")
+      add_type_config
+    end
+
+    def destroy_age_entity(age_type)
+      file_path = File.join(destination_root, "app/#{age_type}s", class_path, "#{file_name}.rb")
+      File.delete(file_path) if File.exist?(file_path)
+      remove_type_config
+    end
+
+    def attributes_list
+      attributes.map { |attr| { name: attr.name, type: attr.type } }
+    end
+
+    def parent_module
+      class_path.map(&:camelize).join('::')
+    end
+
+    def unique_attributes
+      attributes_list.map { |attr| attr[:name].to_sym }
+    end
+
+    def full_class_name
+      parent_module.empty? ? class_name : "#{parent_module}::#{class_name}"
+    end
+
+    def indented_namespace
+      return '' if parent_module.empty?
+
+      parent_module.split('::').map.with_index do |namespace, index|
+        "#{'  ' * index}module #{namespace}"
+      end.join("\n") + "\n"
+    end
+
+    # def indented_end_namespace
+    #   return '' if parent_module.empty?
+
+    #   parent_module.split('::').map.with_index do |_, index|
+    #     "#{'  ' * (parent_module.split('::').length - 1 - index)}end"
+    #   end.join("\n") + "\n"
+    # end
+
+    def add_type_config
+      return unless File.exist?(types_config_file)
+
+      types_content = File.read(types_config_file)
+      types_content.sub!(/^end\s*$/, "#{new_type_content}end")
+      File.open(types_config_file, 'w') { |file| file.write(types_content) }
+      puts "      modified: config/initializers/types.rb"
+    end
+
+    def remove_type_config
+      return unless File.exist?(types_config_file)
+
+      type_to_remove = new_type_content
+
+      types_content = File.read(types_config_file)
+      types_content.gsub!(type_to_remove, '')
+      File.open(types_config_file, 'w') { |file| file.write(types_content) }
+    end
+
+    def types_config_file = File.join(Rails.root, 'config/initializers/types.rb')
+
+    def new_type_content
+      file_path = [class_path, file_name].reject(&:blank?).join('/').downcase
+      entity_namespace = class_path.map(&:capitalize).join('::')
+      entity_class_name = file_name.split('_').map(&:capitalize).join
+      entity_namespaced_class = [entity_namespace, entity_class_name].reject(&:blank?).join('::')
+      type_name = [class_path.join('_'), file_name].reject(&:blank?).join('_')
+      content =
+<<-RUBY
+  require_dependency '#{file_path}'
+  ActiveModel::Type.register(
+    :#{type_name}, ApacheAge::Types::AgeTypeGenerator.create_type_for(#{entity_namespaced_class})
+  )
+RUBY
+    end
+  end
+end

data/lib/generators/apache_age/generator_resource_helpers.rb

@@ -0,0 +1,6 @@
+module ApacheAge
+  # Some helpers for generating scaffolding
+  module GeneratorResourceHelpers
+
+  end
+end

data/lib/generators/apache_age/node/USAGE

@@ -14,16 +14,16 @@ Example:
         class Cat
           include ApacheAge::Entities::Vertex
 
-          attribute :name, :string
-          attribute :age, :integer
+          attribute :full_name, :string
+          attribute :birthdate, :date
 
-          validates :name, presence: true
-          validates :age, presence: true
+          validates :full_name, presence: true
+          validates :birthdate, presence: true
 
           # unique node validator (remove any attributes that are not important to uniqueness)
           validates_with(
-            ApacheAge::Validators::UniqueVertexValidator,
-            attributes: [:name, :age]
+            ApacheAge::Validators::UniqueVertex,
+            attributes: [:full_name, :birthdate]
           )
         end
         ```
@@ -47,7 +47,7 @@ Example:
 
           # unique node validator (remove any attributes that are not important to uniqueness)
           validates_with(
-            ApacheAge::Validators::UniqueVertexValidator,
+            ApacheAge::Validators::UniqueVertex,
             attributes: [:name, :age]
           )
         end

data/lib/generators/apache_age/node/node_generator.rb

@@ -1,94 +1,21 @@
+# lib/generators/apache_age/node/entity_generator.rb
 require 'rails/generators'
 require 'rails/generators/named_base'
 
+require_relative '../generator_entity_helpers'
+
 module ApacheAge
   class NodeGenerator < Rails::Generators::NamedBase
+    include ApacheAge::GeneratorEntityHelpers
+
+    desc "Generates node (model) with attributes."
+
     source_root File.expand_path('templates', __dir__)
     argument :attributes, type: :array, default: [], banner: "field:type field:type"
 
     def perform_task
-      behavior == :invoke ? create_node_file : destroy_node_file
-    end
-
-    private
-
-    def create_node_file
-      template "node.rb.tt", File.join(destination_root, "app/nodes", class_path, "#{file_name}.rb")
-      add_type_config
-    end
-
-    def destroy_node_file
-      file_path = File.join(destination_root, "app/nodes", class_path, "#{file_name}.rb")
-      File.delete(file_path) if File.exist?(file_path)
-      remove_type_config
-    end
-
-    def attributes_list
-      attributes.map { |attr| { name: attr.name, type: attr.type } }
-    end
-
-    def unique_attributes
-      attributes_list.map { |attr| attr[:name].to_sym }
-    end
-
-    def parent_module
-      class_path.map(&:camelize).join('::')
-    end
-
-    def full_class_name
-      parent_module.empty? ? class_name : "#{parent_module}::#{class_name}"
-    end
-
-    def indented_namespace
-      return '' if parent_module.empty?
-
-      parent_module.split('::').map.with_index do |namespace, index|
-        "#{'  ' * index}module #{namespace}"
-      end.join("\n") + "\n"
-    end
-
-    def indented_end_namespace
-      return '' if parent_module.empty?
-
-      parent_module.split('::').map.with_index do |_, index|
-        "#{'  ' * (parent_module.split('::').length - 1 - index)}end"
-      end.join("\n") + "\n"
-    end
-
-    def add_type_config
-      return unless File.exist?(types_config_file)
-
-      types_content = File.read(types_config_file)
-      types_content.sub!(/^end\s*$/, "#{new_type_content}end")
-      File.open(types_config_file, 'w') { |file| file.write(types_content) }
-      puts "      modified: config/initializers/types.rb"
-    end
-
-    def remove_type_config
-      return unless File.exist?(types_config_file)
-
-      type_to_remove = new_type_content
-
-      types_content = File.read(types_config_file)
-      types_content.gsub!(type_to_remove, '')
-      File.open(types_config_file, 'w') { |file| file.write(types_content) }
-    end
-
-    def types_config_file = File.join(Rails.root, 'config/initializers/types.rb')
-
-    def new_type_content
-      file_path = [class_path, file_name].reject(&:blank?).join('/').downcase
-      node_namespace = class_path.map(&:capitalize).join('::')
-      node_class_name = file_name.split('_').map(&:capitalize).join
-      node_namespaced_class = [node_namespace, node_class_name].reject(&:blank?).join('::')
-      type_name = [class_path.join('_'), file_name].reject(&:blank?).join('_')
-      content =
-<<-RUBY
-  require_dependency '#{file_path}'
-  ActiveModel::Type.register(
-    :#{type_name}, ApacheAge::Types::AgeTypeGenerator.create_type_for(#{node_namespaced_class})
-  )
-RUBY
+      age_type = 'node'
+      behavior == :invoke ? generate_age_entity(age_type) : destroy_age_entity(age_type)
     end
   end
 end

data/lib/generators/apache_age/node/templates/node.rb.tt

@@ -9,9 +9,9 @@ class <%= class_name %>
   validates :<%= attribute[:name] %>, presence: true
 <%- end -%>
 
-  # unique node validator (remove any attributes that are not important to uniqueness)
+  # custom unique node validator (remove any attributes that are NOT important to uniqueness)
   validates_with(
-    ApacheAge::Validators::UniqueVertexValidator,
+    ApacheAge::Validators::UniqueVertex,
     attributes: <%= unique_attributes.inspect %>
   )
 end

data/lib/generators/apache_age/scaffold_node/USAGE

@@ -0,0 +1,16 @@
+Description:
+    Explain the generator
+
+Example:
+    bin/rails generate apache_age:scaffold_node Pet name birthdate:date
+
+    This will create:
+        create  app/nodes/pet.rb
+        modified: config/initializers/types.rb
+        create  app/controllers/pets_controller.rb
+        route  resources :pets
+        create  app/views/pets/index.html.erb
+        create  app/views/pets/edit.html.erb
+        create  app/views/pets/show.html.erb
+        create  app/views/pets/new.html.erb
+        create  app/views/pets/partial.html.erb

data/lib/generators/apache_age/scaffold_node/scaffold_node_generator.rb

@@ -0,0 +1,68 @@
+# lib/generators/apache_age/scaffold_node/scaffold_node_generator.rb
+
+require 'rails/generators'
+require 'rails/generators/named_base'
+require 'rails/generators/resource_helpers'
+
+require_relative '../generator_entity_helpers'
+require_relative '../generator_resource_helpers'
+
+module ApacheAge
+  class ScaffoldNodeGenerator < Rails::Generators::NamedBase
+    include Rails::Generators::ResourceHelpers
+    # include ApacheAge::GeneratorEntityHelpers
+    # include ApacheAge::GeneratorResourceHelpers
+
+    desc "Generates a node, and its controller and views with the given attributes."
+
+    source_root File.expand_path("templates", __dir__)
+
+    argument :attributes, type: :array, default: [], banner: "field:type field:type"
+
+    def create_model_file
+      invoke 'apache_age:node', [name] + attributes.collect { |attr| "#{attr.name}:#{attr.type}" }
+    end
+
+    def create_controller_files
+      template(
+        "node_controller.rb.tt",
+        File.join("app/controllers", controller_class_path, "#{controller_file_name}_controller.rb")
+      )
+    end
+
+    def create_route
+      if class_path.empty?
+        route "resources :#{file_name.pluralize}"
+      else
+        route nested_route(class_path, file_name)
+      end
+    end
+
+    def copy_view_files
+      available_views.each do |view|
+        view_name = view == 'partial' ? "_#{singular_table_name}" : view
+        filename = filename_with_extensions(view_name)
+        template "views/#{view}.html.erb.tt", File.join("app/views", controller_file_path, filename)
+      end
+    end
+
+    private
+
+    def available_views
+      %w[index edit show new partial _form]
+    end
+
+    def filename_with_extensions(view)
+      [view, :html, :erb].compact.join('.')
+    end
+
+    def nested_route(class_path, file_name)
+      # "namespace :#{class_path.join(':')} do\n  resources :#{file_name.pluralize}\nend"
+      <<~RUBY
+      namespace :#{class_path.join(':')} do
+        resources :#{file_name.pluralize}
+      end
+      RUBY
+    end
+  end
+end

data/lib/generators/apache_age/scaffold_node/templates/node_controller.rb.tt

@@ -0,0 +1,50 @@
+class <%= controller_class_name %>Controller < ApplicationController
+  before_action :set_<%= singular_table_name %>, only: %i[show edit update destroy]
+
+  def index
+    @<%= plural_table_name %> = <%= class_name %>.all
+  end
+
+  def show
+  end
+
+  def new
+    @<%= singular_table_name %> = <%= class_name %>.new
+  end
+
+  def edit
+  end
+
+  def create
+    @<%= singular_table_name %> = <%= class_name %>.new(<%= singular_table_name %>_params)
+
+    if @<%= singular_table_name %>.save
+      redirect_to @<%= singular_table_name %>, notice: '<%= human_name %> was successfully created.'
+    else
+      render :new
+    end
+  end
+
+  def update
+    if @<%= singular_table_name %>.update(<%= singular_table_name %>_params)
+      redirect_to @<%= singular_table_name %>, notice: '<%= human_name %> was successfully updated.'
+    else
+      render :edit
+    end
+  end
+
+  def destroy
+    @<%= singular_table_name %>.destroy
+    redirect_to <%= index_helper %>_url, notice: '<%= human_name %> was successfully destroyed.'
+  end
+
+  private
+
+  def set_<%= singular_table_name %>
+    @<%= singular_table_name %> = <%= class_name %>.find(params[:id])
+  end
+
+  def <%= singular_table_name %>_params
+    params.require(:<%= singular_table_name %>).permit(<%= attributes.map { |attr| ":#{attr.name}" }.join(', ') %>)
+  end
+end

data/lib/generators/apache_age/scaffold_node/templates/views/_form.html.erb copy.tt

@@ -0,0 +1,37 @@
+<%%= form_with(model: <%= model_resource_name %>) do |form| %>
+  <%% if <%= singular_table_name %>.errors.any? %>
+    <div style="color: red">
+      <h2><%%= pluralize(<%= singular_table_name %>.errors.count, "error") %> prohibited this <%= singular_table_name %> from being saved:</h2>
+
+      <ul>
+        <%% <%= singular_table_name %>.errors.each do |error| %>
+          <li><%%= error.full_message %></li>
+        <%% end %>
+      </ul>
+    </div>
+  <%% end %>
+
+<% attributes.each do |attribute| -%>
+  <div>
+<% if attribute.password_digest? -%>
+    <%%= form.label :password, style: "display: block" %>
+    <%%= form.password_field :password %>
+  </div>
+
+  <div>
+    <%%= form.label :password_confirmation, style: "display: block" %>
+    <%%= form.password_field :password_confirmation %>
+<% elsif attribute.attachments? -%>
+    <%%= form.label :<%= attribute.column_name %>, style: "display: block" %>
+    <%%= form.<%= attribute.field_type %> :<%= attribute.column_name %>, multiple: true %>
+<% else -%>
+    <%%= form.label :<%= attribute.column_name %>, style: "display: block" %>
+    <%%= form.<%= attribute.field_type %> :<%= attribute.column_name %> %>
+<% end -%>
+  </div>
+
+<% end -%>
+  <div>
+    <%%= form.submit %>
+  </div>
+<%% end %>

data/lib/generators/apache_age/scaffold_node/templates/views/_form.html.erb.tt

@@ -0,0 +1,37 @@
+<%%= form_with(model: <%= model_resource_name %>) do |form| %>
+  <%% if <%= singular_table_name %>.errors.any? %>
+    <div style="color: red">
+      <h2><%%= pluralize(<%= singular_table_name %>.errors.count, "error") %> prohibited this <%= singular_table_name %> from being saved:</h2>
+
+      <ul>
+        <%% <%= singular_table_name %>.errors.each do |error| %>
+          <li><%%= error.full_message %></li>
+        <%% end %>
+      </ul>
+    </div>
+  <%% end %>
+
+<% attributes.each do |attribute| -%>
+  <div>
+<% if attribute.password_digest? -%>
+    <%%= form.label :password, style: "display: block" %>
+    <%%= form.password_field :password %>
+  </div>
+
+  <div>
+    <%%= form.label :password_confirmation, style: "display: block" %>
+    <%%= form.password_field :password_confirmation %>
+<% elsif attribute.attachments? -%>
+    <%%= form.label :<%= attribute.column_name %>, style: "display: block" %>
+    <%%= form.<%= attribute.field_type %> :<%= attribute.column_name %>, multiple: true %>
+<% else -%>
+    <%%= form.label :<%= attribute.column_name %>, style: "display: block" %>
+    <%%= form.<%= attribute.field_type %> :<%= attribute.column_name %> %>
+<% end -%>
+  </div>
+
+<% end -%>
+  <div>
+    <%%= form.submit %>
+  </div>
+<%% end %>

data/lib/generators/apache_age/scaffold_node/templates/views/edit.html.erb copy.tt

@@ -0,0 +1,12 @@
+<%% content_for :title, "Editing <%= human_name.downcase %>" %>
+
+<h1>Editing <%= human_name.downcase %></h1>
+
+<%%= render "form", <%= singular_table_name %>: @<%= singular_table_name %> %>
+
+<br>
+
+<div>
+  <%%= link_to "Show this <%= human_name.downcase %>", <%= model_resource_name(prefix: "@") %> %> |
+  <%%= link_to "Back to <%= human_name.pluralize.downcase %>", <%= index_helper(type: :path) %> %>
+</div>

data/lib/generators/apache_age/scaffold_node/templates/views/edit.html.erb.tt

@@ -0,0 +1,12 @@
+<%% content_for :title, "Editing <%= human_name.downcase %>" %>
+
+<h1>Editing <%= human_name.downcase %></h1>
+
+<%%= render "form", <%= singular_table_name %>: @<%= singular_table_name %> %>
+
+<br>
+
+<div>
+  <%%= link_to "Show this <%= human_name.downcase %>", <%= model_resource_name(prefix: "@") %> %> |
+  <%%= link_to "Back to <%= human_name.pluralize.downcase %>", <%= index_helper(type: :path) %> %>
+</div>

data/lib/generators/apache_age/scaffold_node/templates/views/index.html.erb copy.tt

@@ -0,0 +1,16 @@
+<p style="color: green"><%%= notice %></p>
+
+<%% content_for :title, "<%= human_name.pluralize %>" %>
+
+<h1><%= human_name.pluralize %></h1>
+
+<div id="<%= plural_table_name %>">
+  <%% @<%= plural_table_name %>.each do |<%= singular_table_name %>| %>
+    <%%= render <%= singular_table_name %> %>
+    <p>
+      <%%= link_to "Show this <%= human_name.downcase %>", <%= model_resource_name(singular_table_name) %> %>
+    </p>
+  <%% end %>
+</div>
+
+<%%= link_to "New <%= human_name.downcase %>", <%= new_helper(type: :path) %> %>

data/lib/generators/apache_age/scaffold_node/templates/views/index.html.erb.tt

@@ -0,0 +1,16 @@
+<p style="color: green"><%%= notice %></p>
+
+<%% content_for :title, "<%= human_name.pluralize %>" %>
+
+<h1><%= human_name.pluralize %></h1>
+
+<div id="<%= plural_table_name %>">
+  <%% @<%= plural_table_name %>.each do |<%= singular_table_name %>| %>
+    <%%= render '<%= singular_table_name %>', <%= singular_table_name %>: <%= singular_table_name %> %>
+    <p>
+      <%%= link_to "Show this <%= human_name.downcase %>", <%= model_resource_name(singular_table_name) %> %>
+    </p>
+  <%% end %>
+</div>
+
+<%%= link_to "New <%= human_name.downcase %>", <%= new_helper(type: :path) %> %>

data/lib/generators/apache_age/scaffold_node/templates/views/new.html.erb copy.tt

@@ -0,0 +1,11 @@
+<%% content_for :title, "New <%= human_name.downcase %>" %>
+
+<h1>New <%= human_name.downcase %></h1>
+
+<%%= render "form", <%= singular_table_name %>: @<%= singular_table_name %> %>
+
+<br>
+
+<div>
+  <%%= link_to "Back to <%= human_name.pluralize.downcase %>", <%= index_helper(type: :path) %> %>
+</div>

data/lib/generators/apache_age/scaffold_node/templates/views/new.html.erb.tt

@@ -0,0 +1,11 @@
+<%% content_for :title, "New <%= human_name.downcase %>" %>
+
+<h1>New <%= human_name.downcase %></h1>
+
+<%%= render "form", <%= singular_table_name %>: @<%= singular_table_name %> %>
+
+<br>
+
+<div>
+  <%%= link_to "Back to <%= human_name.pluralize.downcase %>", <%= index_helper(type: :path) %> %>
+</div>

data/lib/generators/apache_age/scaffold_node/templates/views/partial.html.erb copy.tt

@@ -0,0 +1,17 @@
+<div id="<%%= dom_id <%= singular_table_name %> %>">
+<% attributes.reject(&:password_digest?).each do |attribute| -%>
+  <p>
+    <strong><%= attribute.human_name %>:</strong>
+<% if attribute.attachment? -%>
+    <%%= link_to <%= singular_table_name %>.<%= attribute.column_name %>.filename, <%= singular_table_name %>.<%= attribute.column_name %> if <%= singular_table_name %>.<%= attribute.column_name %>.attached? %>
+<% elsif attribute.attachments? -%>
+    <%% <%= singular_table_name %>.<%= attribute.column_name %>.each do |<%= attribute.singular_table_name %>| %>
+      <div><%%= link_to <%= attribute.singular_table_name %>.filename, <%= attribute.singular_table_name %> %></div>
+    <%% end %>
+<% else -%>
+    <%%= <%= singular_table_name %>.<%= attribute.column_name %> %>
+<% end -%>
+  </p>
+
+<% end -%>
+</div>

data/lib/generators/apache_age/scaffold_node/templates/views/partial.html.erb.tt

@@ -0,0 +1,17 @@
+<div id="<%%= dom_id <%= singular_table_name %> %>">
+<% attributes.reject(&:password_digest?).each do |attribute| -%>
+  <p>
+    <strong><%= attribute.human_name %>:</strong>
+<% if attribute.attachment? -%>
+    <%%= link_to <%= singular_table_name %>.<%= attribute.column_name %>.filename, <%= singular_table_name %>.<%= attribute.column_name %> if <%= singular_table_name %>.<%= attribute.column_name %>.attached? %>
+<% elsif attribute.attachments? -%>
+    <%% <%= singular_table_name %>.<%= attribute.column_name %>.each do |<%= attribute.singular_name %>| %>
+      <div><%%= link_to <%= attribute.singular_name %>.filename, <%= attribute.singular_name %> %></div>
+    <%% end %>
+<% else -%>
+    <%%= <%= singular_table_name %>.<%= attribute.column_name %> %>
+<% end -%>
+  </p>
+
+<% end -%>
+</div>

data/lib/generators/apache_age/scaffold_node/templates/views/show.html.erb copy.tt

@@ -0,0 +1,10 @@
+<p style="color: green"><%%= notice %></p>
+
+<%%= render @<%= singular_table_name %> %>
+
+<div>
+  <%%= link_to "Edit this <%= human_name.downcase %>", <%= edit_helper(type: :path) %> %> |
+  <%%= link_to "Back to <%= human_name.pluralize.downcase %>", <%= index_helper(type: :path) %> %>
+
+  <%%= button_to "Destroy this <%= human_name.downcase %>", <%= model_resource_name(prefix: "@") %>, method: :delete %>
+</div>

data/lib/generators/apache_age/scaffold_node/templates/views/show.html.erb.tt

@@ -0,0 +1,10 @@
+<p style="color: green"><%%= notice %></p>
+
+<%%= render '<%= singular_table_name %>', <%= singular_table_name %>: @<%= singular_table_name %> %>
+
+<div>
+  <%%= link_to "Edit this <%= human_name.downcase %>", <%= edit_helper(type: :path) %> %> |
+  <%%= link_to "Back to <%= human_name.pluralize.downcase %>", <%= index_helper(type: :path) %> %>
+
+  <%%= button_to "Destroy this <%= human_name.downcase %>", <%= model_resource_name(prefix: "@") %>, method: :delete %>
+</div>

data/lib/rails_age/version.rb

@@ -1,3 +1,3 @@
 module RailsAge
-  VERSION = '0.4.1'
+  VERSION = '0.5.2'
 end

data/lib/rails_age.rb

@@ -11,7 +11,7 @@ module ApacheAge
   require 'apache_age/entities/edge'
   require 'apache_age/entities/entity'
   require 'apache_age/entities/vertex'
+  require 'apache_age/validators/unique_edge'
+  require 'apache_age/validators/unique_vertex'
   require 'apache_age/types/age_type_generator'
-  require 'apache_age/validators/unique_edge_validator'
-  require 'apache_age/validators/unique_vertex_validator'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_age
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.2
 platform: ruby
 authors:
 - Bill Tihen
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-15 00:00:00.000000000 Z
+date: 2024-06-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -73,15 +73,32 @@ files:
 - lib/apache_age/entities/entity.rb
 - lib/apache_age/entities/vertex.rb
 - lib/apache_age/types/age_type_generator.rb
-- lib/apache_age/validators/unique_edge_validator.rb
-- lib/apache_age/validators/unique_vertex_validator.rb
+- lib/apache_age/validators/unique_edge.rb
+- lib/apache_age/validators/unique_vertex.rb
 - lib/apache_age/validators/vertex_type_validator.rb
 - lib/generators/apache_age/edge/USAGE
 - lib/generators/apache_age/edge/edge_generator.rb
 - lib/generators/apache_age/edge/templates/edge.rb.tt
+- lib/generators/apache_age/generator_entity_helpers.rb
+- lib/generators/apache_age/generator_resource_helpers.rb
 - lib/generators/apache_age/node/USAGE
 - lib/generators/apache_age/node/node_generator.rb
 - lib/generators/apache_age/node/templates/node.rb.tt
+- lib/generators/apache_age/scaffold_node/USAGE
+- lib/generators/apache_age/scaffold_node/scaffold_node_generator.rb
+- lib/generators/apache_age/scaffold_node/templates/node_controller.rb.tt
+- lib/generators/apache_age/scaffold_node/templates/views/_form.html.erb copy.tt
+- lib/generators/apache_age/scaffold_node/templates/views/_form.html.erb.tt
+- lib/generators/apache_age/scaffold_node/templates/views/edit.html.erb copy.tt
+- lib/generators/apache_age/scaffold_node/templates/views/edit.html.erb.tt
+- lib/generators/apache_age/scaffold_node/templates/views/index.html.erb copy.tt
+- lib/generators/apache_age/scaffold_node/templates/views/index.html.erb.tt
+- lib/generators/apache_age/scaffold_node/templates/views/new.html.erb copy.tt
+- lib/generators/apache_age/scaffold_node/templates/views/new.html.erb.tt
+- lib/generators/apache_age/scaffold_node/templates/views/partial.html.erb copy.tt
+- lib/generators/apache_age/scaffold_node/templates/views/partial.html.erb.tt
+- lib/generators/apache_age/scaffold_node/templates/views/show.html.erb copy.tt
+- lib/generators/apache_age/scaffold_node/templates/views/show.html.erb.tt
 - lib/rails_age.rb
 - lib/rails_age/engine.rb
 - lib/rails_age/version.rb