inline_forms 7.10.2 → 7.11.0

data/bin/inline_forms_installer_core.rb

@@ -1,886 +0,0 @@
-GENERATOR_PATH = File.dirname(File.expand_path(__FILE__)) +  '/../'
-
-# Rails 7 dropped --skip-gemfile, so `rails new` always writes its own Gemfile.
-# Remove it so our `create_file` below does not prompt for overwrite.
-remove_file 'Gemfile' if File.exist?('Gemfile')
-create_file 'Gemfile', "# created by inline_forms #{ENV['inline_forms_version']} on #{Date.today}\n"
-
-# `rails new` is invoked with whatever the system `rails` binary points at
-# (often Rails 8.x once it lands in the global gemset), so the generated
-# `config/application.rb` may carry Rails 7.1+/8.0 idioms (`load_defaults
-# 8.0`, `config.autoload_lib(...)`). The Gemfile we write below pins
-# `rails ~> 7.0.0`, so Rails 7.0 must be able to interpret application.rb;
-# otherwise the first `bundle exec rails …` aborts with `Unknown version
-# "8.0"` or `NoMethodError: undefined method 'autoload_lib'`.
-if File.exist?('config/application.rb')
-  gsub_file 'config/application.rb',
-            /config\.load_defaults\s+\d+\.\d+/,
-            'config.load_defaults 7.1'
-  # Strip Rails 7.1+ `config.autoload_lib(ignore: ...)` (and any surrounding
-  # explanatory comment block). Not supported on Rails 7.0.
-  gsub_file 'config/application.rb',
-            /^\s*#[^\n]*\n(\s*#[^\n]*\n)*\s*config\.autoload_lib\([^)]*\)\s*\n/,
-            ""
-  gsub_file 'config/application.rb',
-            /^\s*config\.autoload_lib\([^)]*\)\s*\n/,
-            ""
-end
-
-add_source 'https://rubygems.org'
-
-gem 'cancancan'
-gem 'carrierwave', '~> 3.1'
-gem 'devise', '~> 5.0'
-gem 'devise-i18n', '~> 1.16'
-gem 'autoprefixer-rails'
-# foundation-rails 6.7+ uses Dart Sass (`sass:math`); sass-rails/sassc removed.
-# Visually tuned against foundation-rails ~> 6.6.2; current pin ~> 6.9 (6.9.0.x).
-gem 'foundation-rails', '~> 6.9'
-gem 'i18n-active_record', :git => 'https://github.com/acesuares/i18n-active_record.git'
-generator_repo = File.expand_path(GENERATOR_PATH)
-# Always use the generator source path (repo checkout OR installed gem dir).
-# This guarantees the generated app uses the exact inline_forms code that
-# launched `inline_forms create`, including unreleased local builds.
-gem 'inline_forms', path: generator_repo
-gem 'jquery-rails'
-gem 'jquery-timepicker-rails'
-# jQuery UI JavaScript (`//= require jquery.ui.all` in inline_forms.js). SCSS + PNGs
-# are vendored in the inline_forms engine (Dart Sass cannot evaluate sass-rails
-# `image-path()`). Pin matches former jquery-ui-sass-rails 4.0.3.x stack.
-gem 'jquery-ui-rails', '4.0.3'
-# Foundation Icons SCSS + fonts are vendored in the inline_forms engine (Dart Sass;
-# foundation-icons-sass-rails depended on sass-rails).
-gem 'mini_magick'
-gem 'mysql2'
-gem 'paper_trail', '~> 16.0'
-gem 'rails-i18n', '~> 7.0'
-gem 'rails-jquery-autocomplete'
-gem 'rails', '~> 7.1.5'
-gem 'rake'
-gem 'rvm'
-gem 'dartsass-rails'
-# Rails 7 no longer adds sprockets-rails to the default Gemfile; declare it
-# explicitly because the gem's own assets (foundation, jquery, etc.) live in
-# app/assets and rely on the Sprockets pipeline.
-gem 'sprockets-rails'
-# Rails 7 default JavaScript tooling: importmap-rails replaces Webpacker.
-gem 'importmap-rails'
-# Hotwire/Turbo. Loaded from layouts as `<script type="module">`; inline flows
-# use `<turbo-frame>` + HTML responses (see docs/ujs-to-turbo.md). Registers the
-# `turbo_stream` MIME type for optional stream responses.
-gem 'turbo-rails'
-gem 'tabs_on_rails', :git => 'https://github.com/acesuares/tabs_on_rails.git', :branch => 'update_remote_before_action'
-gem 'unicorn'
-gem 'validation_hints', '~> 6.3'
-gem 'will_paginate' #, git: 'https://github.com/acesuares/will_paginate.git'
-
-gem_group :test do
-  # Rails 7 still expects Minitest 5; 6.x breaks the railties test runner.
-  gem 'minitest', '~> 5.25'
-end
-
-gem_group :development do
-  gem 'capistrano-bundler', require: false
-  gem 'capistrano-rails', require: false
-  gem 'capistrano', require: false
-  gem 'capistrano3-unicorn'
-  gem 'listen'
-  gem 'rvm-capistrano', :require => false
-  gem 'rvm1-capistrano3', require: false
-  gem 'seed_dump', '~> 0.5.3'
-  # Rails 6.1 ActiveRecord's sqlite3 adapter requires sqlite3 ~> 1.4; 2.x activates first and breaks.
-  gem 'sqlite3', '~> 1.4'
-  gem 'thin'
-  gem 'yaml_db'
-end
-
-gem_group :production do
-  gem 'mini_racer'
-  gem 'uglifier'
-end
-
-say "- Running bundle..."
-run "gem install bundler"
-vh_gem_dirs = [
-  ENV["VALIDATION_HINTS_ROOT"],
-  File.expand_path("~/validation_hints"),
-  File.expand_path("~/code/validation_hints"),
-  File.expand_path("../validation_hints", GENERATOR_PATH)
-].compact.uniq
-vh_gem = vh_gem_dirs.flat_map { |dir| Dir[File.join(dir, "validation_hints-*.gem")] }.sort.last
-if vh_gem && File.file?(vh_gem)
-  say "- Installing #{File.basename(vh_gem)} (local build; not on RubyGems yet)..."
-  run "gem install #{vh_gem} --no-document"
-end
-run "bundle install"
-
-say "- Dart Sass: inline_forms stylesheet entrypoints + initializer..."
-copy_file File.join(GENERATOR_PATH, "lib/installer_templates/dartsass/inline_forms_dartsass_builds.rb"),
-          "config/initializers/inline_forms_dartsass_builds.rb"
-copy_file File.join(GENERATOR_PATH, "lib/installer_templates/dartsass/inline_forms_main.scss"),
-          "app/assets/stylesheets/inline_forms_install/inline_forms_main.scss"
-copy_file File.join(GENERATOR_PATH, "lib/installer_templates/dartsass/devise_main.scss"),
-          "app/assets/stylesheets/inline_forms_install/devise_main.scss"
-
-say "- Dart Sass: rails dartsass:install (builds/, manifest, Procfile.dev)..."
-run "bundle exec rails dartsass:install"
-
-say "- Dart Sass: drop default application.css (manifest links builds/*.css only)..."
-remove_file "app/assets/stylesheets/application.css"
-
-insert_into_file "test/test_helper.rb", <<~'DARTSASS_TEST', after: %(require "rails/test_help"\n)
-
-  # Dart Sass writes CSS to app/assets/builds; Sprockets does not compile .scss.
-  Rails.application.load_tasks
-  Rake::Task["dartsass:build"].invoke
-DARTSASS_TEST
-
-say "- Database setup: creating config/database.yml with development database #{ENV['database']}"
-remove_file "config/database.yml" # the one that 'rails new' created
-if ENV['using_sqlite'] == 'true'
-  create_file "config/database.yml", <<-END_DATABASEYML.strip_heredoc
-  development:
-    adapter: sqlite3
-    database: db/development.sqlite3
-    pool: 5
-    timeout: 5000
-
-  test:
-    adapter: sqlite3
-    database: db/test.sqlite3
-    pool: 5
-    timeout: 5000
-
-  END_DATABASEYML
-else
-  create_file "config/database.yml", <<-END_DATABASEYML.strip_heredoc
-  development:
-    adapter: mysql2
-    database: <%= Rails.application.credentials[:db_name] %>
-    username: <%= Rails.application.credentials[:db_username] %>
-    password: <%= Rails.application.credentials[:db_password] %>
-  END_DATABASEYML
-
-say "- Setting development database in credentials"
-create_file "temp_development_database_credentials", <<-END_DEV_DB_CRED.strip_heredoc
-
-  # development database
-  db_name: #{app_name.downcase}_dev
-  db_username: #{app_name.downcase}_dev_user
-  db_password: #{app_name.downcase}_dev_password
-
-END_DEV_DB_CRED
-
-run "EDITOR='cat temp_development_database_credentials >> ' rails credentials:edit"
-
-remove_file 'temp_development_database_credentials'
-
-say "\n *** Please make sure to create a mysql development database with the following credentials:
-    db_name: #{app_name.downcase}_dev
-    db_username: #{app_name.downcase}_dev_user
-    db_password: #{app_name.downcase}_dev_password
-
-    or use 'rails credentials:edit' to change these values.\n\n", :red
-
-end
-append_file "config/database.yml", <<-END_DATABASEYML.strip_heredoc
-  production:
-    adapter: mysql2
-    database: <%= Rails.application.credentials[:db_name] %>
-    username: <%= Rails.application.credentials[:db_username] %>
-    password: <%= Rails.application.credentials[:db_password] %>
-END_DATABASEYML
-
-say "Setting production database in credentials"
-create_file "temp_production_database_credentials", <<-END_PROD_DB_CRED.strip_heredoc
-
-  # production database
-  db_name: #{app_name.downcase}_prod
-  db_username: #{app_name.downcase}_prod_user
-  db_password:
-
-END_PROD_DB_CRED
-
-run "EDITOR='cat temp_production_database_credentials >> ' rails credentials:edit --environment production"
-
-remove_file 'temp_production_database_credentials'
-
-say "\n *** Please make sure to create a mysql production database and use 'rails credentials:edit' to set the password.\n\n", :red
-
-say "- Devise install..."
-run "bundle exec rails g devise:install"
-
-say "- Create Devise route and add path_prefix..."
-
-route <<-ROUTE.strip_heredoc
-devise_for :users, :path_prefix => 'auth'
-  resources :users do
-    post 'revert', :on => :member
-    get 'list_versions', :on => :member
-end
-ROUTE
-
-say "- Create devise migration file"
-
-sleep 1 # to get unique migration number
-create_file "db/migrate/" +
-  Time.now.utc.strftime("%Y%m%d%H%M%S") +
-  "_" +
-  "devise_create_users.rb", <<-DEVISE_MIGRATION.strip_heredoc
-class DeviseCreateUsers < ActiveRecord::Migration[7.1]
-
-  def change
-    create_table(:users) do |t|
-      ## Database authenticatable
-      t.string :email,              null: false, default: ""
-      t.string :encrypted_password, null: false, default: ""
-
-      ## Recoverable
-      t.string   :reset_password_token
-      t.datetime :reset_password_sent_at
-
-      ## Rememberable
-      t.datetime :remember_created_at
-
-      ## Trackable
-      t.integer  :sign_in_count, default: 0, null: false
-      t.datetime :current_sign_in_at
-      t.datetime :last_sign_in_at
-      t.string   :current_sign_in_ip
-      t.string   :last_sign_in_ip
-
-      ## Confirmable
-      # t.string   :confirmation_token
-      # t.datetime :confirmed_at
-      # t.datetime :confirmation_sent_at
-      # t.string   :unconfirmed_email # Only if using reconfirmable
-
-      ## Lockable
-      # t.integer  :failed_attempts, default: 0, null: false # Only if lock strategy is :failed_attempts
-      # t.string   :unlock_token # Only if unlock strategy is :email or :both
-      # t.datetime :locked_at
-
-      t.string :name
-      t.integer :locale_id
-
-      t.timestamps
-    end
-
-    add_index :users, :email,                unique: true
-    add_index :users, :reset_password_token, unique: true
-    # add_index :users, :confirmation_token,   unique: true
-    # add_index :users, :unlock_token,         unique: true
-  end
-end
-DEVISE_MIGRATION
-
-say "- Create User Controller..."
-create_file "app/controllers/users_controller.rb", <<-USERS_CONTROLLER.strip_heredoc
-  class UsersController < InlineFormsController
-    set_tab :user
-  end
-USERS_CONTROLLER
-
-say "- Create User Model..."
-create_file "app/models/user.rb", <<-USER_MODEL.strip_heredoc
-  class User < ApplicationRecord
-
-    # devise options
-    devise :database_authenticatable
-    # devise :registerable # uncomment this if you want people to be able to register
-    devise :recoverable
-    devise :rememberable
-    devise :trackable
-    devise :validatable
-    # devise :token_authenticatable
-    # devise :confirmable,
-    # devise :lockable
-    # devise :timeoutable
-    # devise :omniauthable
-
-    # Setup accessible (or protected) attributes for your model
-    attr_writer :inline_forms_attribute_list
-    #attr_accessible :email, :password, :locale, :remember_me
-
-    belongs_to :locale
-    has_and_belongs_to_many :roles
-
-    # validations
-    validates :name, :presence => true
-
-    default_scope {order :name}
-
-    # pagination
-    attr_reader :per_page
-    @per_page = 7
-
-    has_paper_trail
-
-    def _presentation
-      "\#{name}"
-    end
-
-    def role?(role)
-      return !!self.roles.find_by_name(role)
-    end
-
-    def inline_forms_attribute_list
-      @inline_forms_attribute_list ||= [
-        [ :header_user_login,         '', :header ],
-        [ :name,                      '', :text_field ],
-        [ :email,                     '', :text_field ],
-        [ :locale ,                   '', :dropdown ],
-        [ :password,                  '', :devise_password_field ],
-        [ :header_user_roles,         '', :header ],
-        [ :roles,                     '', :check_list ],
-        [ :header_user_other_stuff,   '', :header ],
-        [ :encrypted_password,        '', :info ],
-        [ :reset_password_token,      '', :info ],
-        [ :reset_password_sent_at,    '', :info],
-        [ :remember_created_at,       '', :info ],
-        [ :sign_in_count,             '', :info ],
-        [ :current_sign_in_at,        '', :info ],
-        [ :last_sign_in_at,           '', :info ],
-        [ :current_sign_in_ip,        '', :info ],
-        [ :last_sign_in_ip,           '', :info ],
-        [ :created_at,                '', :info ],
-        [ :updated_at,                '', :info ],
-      ]
-    end
-
-    def self.not_accessible_through_html?
-      false
-    end
-
-    def self.order_by_clause
-      nil
-    end
-
-  end
-USER_MODEL
-
-# Create Locales
-say "- Create locales"
-generate "inline_forms", "Locale name:string title:string users:has_many _enabled:yes _presentation:\#{title}"
-append_to_file "db/seeds.rb", "Locale.create({ id: 1, name: 'en', title: 'English' })\n"
-
-# Create Roles
-say "- Create roles"
-generate "inline_forms", "Role name:string description:text users:has_and_belongs_to_many _enabled:yes _presentation:\#{name}"
-append_to_file "db/seeds.rb", "Role.create({ id: 1, name: 'superadmin', description: 'Super Admin can access all.' })\n"
-
-# Create Admin User
-
-say "- Adding admin user with email: #{ENV['email']}, password: #{ENV['password']} to seeds.rb"
-append_to_file "db/seeds.rb", "User.create({ id: 1, email: '#{ENV['email']}', locale_id: 1, name: 'Admin', password: '#{ENV['password']}', password_confirmation: '#{ENV['password']}' })\n"
-
-
-sleep 1 # to get unique migration number
-create_file "db/migrate/" +
-  Time.now.utc.strftime("%Y%m%d%H%M%S") +
-  "_" +
-  "inline_forms_create_join_table_user_role.rb", <<-ROLES_MIGRATION.strip_heredoc
-  class InlineFormsCreateJoinTableUserRole < ActiveRecord::Migration[7.1]
-    def self.up
-      create_table  :roles_users, :id => false, :force => true do |t|
-        t.integer   :role_id
-        t.integer   :user_id
-      end
-      execute 'INSERT INTO roles_users VALUES (1,1);'
-    end
-
-    def self.down
-      drop_table roles_users
-    end
-  end
-ROLES_MIGRATION
-
-
-say "- Installaing ZURB Foundation..."
-#generate "foundation:install", "-f"
-
-say "- Copy inline_forms_devise file for custom styles..."
-copy_file File.join(GENERATOR_PATH, 'lib/generators/assets/stylesheets/inline_forms_devise.css'), 'app/assets/stylesheets/inline_forms_devise.css'
-
-say "- Sprockets: link inline_forms_devise.css (logical path; dartsass:install drops link_directory ../stylesheets)..."
-append_to_file "app/assets/config/manifest.js", "//= link inline_forms_devise.css\n"
-
-say "- Add human_attribute_name in app/models/application_record.rb"
-remove_file 'app/models/application_record.rb' # the one that 'rails new' created
-copy_file File.join(GENERATOR_PATH, 'lib/generators/templates/application_record.rb'), "app/models/application_record.rb"
-
-say "- Install ActionText..."
-run "bundle exec rails active_storage:install"
-run "bundle exec rails action_text:install:migrations"
-run "bundle install"
-
-say "- Paper_trail install..."
-# Upstream paper_trail (>= 13) detects MySQL via the live ActiveRecord connection,
-# so the migration's InnoDB options are added only when the dev DB is mysql.
-# For mysql installs the user has been instructed above to create the development
-# database before continuing; for sqlite the file is created on first connection.
-generate "paper_trail:install --with-changes"
-# paper_trail emits two migrations in one second; the next generator would reuse that timestamp.
-sleep 1
-
-say "- Track ActionText (rich_text) edits with PaperTrail..."
-# `has_rich_text :foo` stores the body in the separate `action_text_rich_texts`
-# table, not on the parent model, so `has_paper_trail` on the parent never
-# sees rich_text edits. The standard fix (recommended by paper_trail's
-# maintainer in https://stackoverflow.com/q/55544935) is to declare
-# `has_paper_trail` directly on `ActionText::RichText`. We surface those
-# versions in the parent's versions panel from `inline_forms_versions_for`.
-#
-# Note: PaperTrail >= 16 raises if `has_paper_trail` is called twice on the
-# same model, so this initializer must be the only place it's added to
-# `ActionText::RichText` in the generated app.
-create_file 'config/initializers/rich_text_paper_trail.rb', <<-PT_RICH_TEXT.strip_heredoc
-  # Generated by inline_forms.
-  ActiveSupport.on_load(:action_text_rich_text) do
-    has_paper_trail
-  end
-PT_RICH_TEXT
-
-say "- Configure ActiveRecord YAML permitted classes for PaperTrail changesets..."
-# PaperTrail's YAML serializer (>= 13) uses `YAML.safe_load` and reads its
-# allow-list from `ActiveRecord.yaml_column_permitted_classes`. Rails 7's
-# default is `[Symbol]`, so any update that touches `updated_at`
-# (an `ActiveSupport::TimeWithZone`) raises `Psych::DisallowedClass` inside
-# `version.changeset`; PaperTrail rescues that and returns `{}`, which is why
-# the inline_forms versions list rendered every changeset as `empty`. Permit
-# the classes PT actually emits so `version.changeset` round-trips.
-create_file 'config/initializers/paper_trail_yaml_safe_load.rb', <<-PT_YAML.strip_heredoc
-  # Generated by inline_forms.
-  # See https://github.com/paper-trail-gem/paper_trail and
-  # ActiveRecord::Coders::YAMLColumn safe-loading rules.
-  Rails.application.config.active_record.yaml_column_permitted_classes ||= []
-  Rails.application.config.active_record.yaml_column_permitted_classes |= [
-    Symbol,
-    Date,
-    Time,
-    BigDecimal,
-    ActiveSupport::TimeWithZone,
-    ActiveSupport::TimeZone,
-    ActiveSupport::HashWithIndifferentAccess
-  ]
-  ActiveRecord.yaml_column_permitted_classes |= Rails.application.config.active_record.yaml_column_permitted_classes
-PT_YAML
-
-# Create Translations
-say "- Generate models and tables and views for translations..." # TODO Translations need to be done in inline_forms, and then generate a yml file, perhaps
-generate "inline_forms", "InlineFormsLocale name:string inline_forms_translations:belongs_to _enabled:yes _presentation:\#{name}"
-sleep 1 # unique migration timestamps per generator
-generate "inline_forms", "InlineFormsKey name:string inline_forms_translations:has_many inline_forms_translations:associated _enabled:yes _presentation:\#{name}"
-sleep 1
-generate "inline_forms", "InlineFormsTranslation inline_forms_key:belongs_to inline_forms_locale:dropdown value:text interpolations:text is_proc:boolean _presentation:\#{value}"
-# Plain long text uses :plain_text; ActionText-backed fields use :rich_text.
-sleep 1 # to get unique migration number
-create_file "db/migrate/" +
-  Time.now.utc.strftime("%Y%m%d%H%M%S") +
-  "_" +
-  "inline_forms_create_view_for_translations.rb", <<-VIEW_MIGRATION.strip_heredoc
-  class InlineFormsCreateViewForTranslations < ActiveRecord::Migration[7.1]
-    def self.up
-      execute 'CREATE VIEW translations
-               AS
-                 SELECT L.name AS locale,
-                        K.name AS thekey,
-                        T.value AS value,
-                        T.interpolations AS interpolations,
-                        T.is_proc AS is_proc
-                   FROM inline_forms_keys K, inline_forms_locales L, inline_forms_translations T
-                     WHERE T.inline_forms_key_id = K.id AND T.inline_forms_locale_id = L.id '
-    end
-    def self.down
-      execute 'DROP VIEW translations'
-    end
-  end
-VIEW_MIGRATION
-
-say "- Creating application title via locales..."
-create_file "config/locales/inline_forms_local.en.yml", <<-END_LOCALE.strip_heredoc
-  en:
-    inline_forms:
-      general:
-        application_title: #{app_name}
-      devise:
-        title_for_devise: #{app_name}
-        welcome: Welcome to #{app_name}!
-END_LOCALE
-
-say "- Migrating Database (only when using sqlite)"
-run "bundle exec rake db:migrate" if ENV['using_sqlite'] == 'true'
-
-say "- Seeding the database (only when using sqlite)"
-run "bundle exec rake db:seed" if ENV['using_sqlite'] == 'true'
-
-say "- Recreating ApplicationHelper to set application_name and application_title..."
-remove_file "app/helpers/application_helper.rb" # the one that 'rails new' created
-create_file "app/helpers/application_helper.rb", <<-END_APPHELPER.strip_heredoc
-  module ApplicationHelper
-    def application_name
-      '#{app_name}'
-    end
-    def application_title
-      '#{app_name}'
-    end
-  end
-END_APPHELPER
-
-say "- Creating inline_forms initializer"
-create_file "config/initializers/inline_forms.rb", <<-END_INITIALIZER.strip_heredoc
-  Rails.application.reloader.to_prepare do
-    MODEL_TABS = %w()
-  end
-END_INITIALIZER
-
-say "- Recreating ApplicationController to add devise, cancan, I18n stuff..."
-remove_file "app/controllers/application_controller.rb" # the one that 'rails new' created
-create_file "app/controllers/application_controller.rb", <<-END_APPCONTROLLER.strip_heredoc
-  class ApplicationController < InlineFormsApplicationController
-    protect_from_forgery
-
-    # add whodunnit
-    before_action :set_paper_trail_whodunnit
-
-    # Comment next lines if you don't want Devise authentication
-    before_action :authenticate_user!
-    check_authorization unless: :devise_controller?
-
-    rescue_from CanCan::AccessDenied do |exception|
-      respond_to do |format|
-        format.json { head :forbidden, content_type: 'text/html' }
-        format.html { redirect_to main_app.root_url, notice: exception.message }
-        format.js   { head :forbidden, content_type: 'text/html' }
-      end
-    end
-    # Comment previous lines if you don't want Devise authentication
-
-    # Uncomment next line if you want I18n (based on subdomain)
-    # before_action :set_locale
-
-    # Uncomment next line and specify default locale
-    # I18n.default_locale = :en
-
-    # Uncomment next line and specify available locales
-    # I18n.available_locales = [ :en, :nl, :pp ]
-
-    # Uncomment next nine line if you want locale based on subdomain, like 'it.example.com, de.example.com'
-    # def set_locale
-    #   I18n.locale = extract_locale_from_subdomain || I18n.default_locale
-    # end
-    #
-    # def extract_locale_from_subdomain
-    #   locale = request.subdomains.first
-    #   return nil if locale.nil?
-    #   I18n.available_locales.include?(locale.to_sym) ? locale.to_s : nil
-    # end
-  end
-END_APPCONTROLLER
-
-say "- Creating Ability model so that the superadmin can access all..."
-create_file "app/models/ability.rb", <<-END_ABILITY.strip_heredoc
-  class Ability
-    include CanCan::Ability
-
-    def initialize(user)
-      # See the wiki for details: https://github.com/CanCanCommunity/cancancan/wiki/Defining-Abilities
-
-      user ||= User.new # guest user
-
-      # use this if you get stuck:
-      # if user.id == 1 #quick hack
-      #   can :manage, :all
-      if user.role? :superadmin
-        can :manage, :all
-      else
-        # put restrictions for other users here
-      end
-    end
-  end
-END_ABILITY
-
-# devise mailer stuff
-say "- Injecting devise mailer stuff in environments/production.rb..."
-# strip_heredoc_with_indent(2) became strip_heredoc(2), but only in rails 4... :-(
-insert_into_file "config/environments/production.rb", <<-DEVISE_MAILER_PROD_STUFF.strip_heredoc, :before => "end\n"
-
-  # for devise
-  config.action_mailer.default_url_options = { protocol: 'https', host: Rails.application.credentials[:smtp_app_host] }
-  config.action_mailer.delivery_method = :smtp
-  config.action_mailer.smtp_settings = {
-    address: Rails.application.credentials[:smtp_host],
-    enable_starttls_auto: true,
-    password: Rails.application.credentials[:smtp_password] ,
-    user_name: Rails.application.credentials[:smtp_username]
-  }
-
-DEVISE_MAILER_PROD_STUFF
-
-say "Setting production smtp settings in credentials"
-create_file "temp_production_smtp_credentials", <<-END_PROD_SMTP_CRED.strip_heredoc
-
-  # devise mailer stuff for production:
-  smtp_app_host: APP_HOST
-  smtp_host: SMTP_HOST
-  smtp_username: USERNAME
-  smtp_password: PASSWORD
-
-END_PROD_SMTP_CRED
-
-run "EDITOR='cat temp_production_smtp_credentials >> ' rails credentials:edit --environment production"
-
-remove_file 'temp_production_smtp_credentials'
-
-say "- Injecting devise mailer stuff in environments/development.rb..."
-# strip_heredoc_with_indent(2) became strip_heredoc(2), but only in rails 4... :-(
-insert_into_file "config/environments/development.rb", <<-DEVISE_MAILER_DEV_STUFF.strip_heredoc, :before => "\nend\n"
-  # for devise
-  config.action_mailer.default_url_options = { protocol: 'http', host: 'localhost', port: 3000 }
-  config.action_mailer.delivery_method = :smtp
-  config.action_mailer.smtp_settings = {
-    address: Rails.application.credentials[:smtp_host],
-    enable_starttls_auto: true,
-    password: Rails.application.credentials[:smtp_password] ,
-    user_name: Rails.application.credentials[:smtp_username]
-  }
-
-DEVISE_MAILER_DEV_STUFF
-
-say "Setting development smtp settings in credentials"
-create_file "temp_development_smtp_credentials", <<-END_DEV_SMTP_CRED.strip_heredoc
-
-  # devise mailers stuff for development:
-  smtp_app_host: APP_HOST
-  smtp_host: SMTP_HOST
-  smtp_username: USERNAME
-  smtp_password: PASSWORD
-
-END_DEV_SMTP_CRED
-
-run "EDITOR='cat temp_development_smtp_credentials >> ' rails credentials:edit"
-
-remove_file 'temp_development_smtp_credentials'
-
-
-
-# capify
-say "- Capify..."
-run 'bundle exec cap install'
-remove_file "config/deploy.rb" # remove the file capify created!
-copy_file File.join(GENERATOR_PATH,'lib/generators/templates/capistrano/deploy.rb'), "config/deploy.rb"
-remove_file "config/deploy/production.rb" # remove the production file capify created!
-copy_file File.join(GENERATOR_PATH,'lib/generators/templates/capistrano/production.rb'), "config/deploy/production.rb"
-remove_file "Capfile" # remove the Capfile file capify created!
-copy_file File.join(GENERATOR_PATH,'lib/generators/templates/capistrano/Capfile'), "Capfile"
-
-# Unicorn
-say "- Unicorn Config..."
-copy_file File.join(GENERATOR_PATH,'lib/generators/templates/unicorn/production.rb'), "config/unicorn/production.rb"
-
-# Git
-say "- adding and committing to git..."
-
-git add: "."
-git commit: " -a -m 'Initial Commit'"
-
-# example
-if ENV['install_example'] == 'true'
-  say "\nInstalling example application..."
-  run 'bundle exec rails g inline_forms Photo name:string caption:string image:image_field description:rich_text apartment:belongs_to _presentation:\'#{name}\''
-  run 'bundle exec rails generate uploader Image'
-  run 'bundle exec rails g inline_forms Apartment name:string title:string opening_date:date description:rich_text photos:has_many photos:associated _enabled:yes _presentation:\'#{name}\''
-
-  say "- Apartment name is required..."
-  inject_into_file "app/models/apartment.rb",
-                   "\n  validates :name, presence: true\n",
-                   after: "  has_paper_trail\n"
-
-  # CarrierWave + PaperTrail history.
-  # PaperTrail snapshots the column scalar (the stored filename) on update,
-  # but CarrierWave's default `remove_previously_stored_files_after_update`
-  # deletes the old file on disk and re-uses the same filename, so a
-  # PaperTrail revert restores a filename whose bytes are gone.
-  # We keep every uploaded file on disk and namespace filenames with a
-  # per-upload token so successive uploads do not collide. See
-  # https://stackoverflow.com/questions/9423279/papertrail-and-carrierwave
-  # (Answers 2, 4 and 5).
-  say "- Configuring CarrierWave to keep previously stored files (PaperTrail history)..."
-  create_file "config/initializers/carrierwave.rb", <<-CWINIT.strip_heredoc
-    # Keep previously stored files on disk so PaperTrail-driven restore
-    # actually returns the previous image bytes. See
-    # https://stackoverflow.com/questions/9423279/papertrail-and-carrierwave
-    # The per-uploader overrides in app/uploaders/image_uploader.rb
-    # complement this by giving every upload a unique on-disk filename
-    # and by no-op'ing `remove!` so destroyed records keep their files.
-    CarrierWave.configure do |config|
-      config.remove_previously_stored_files_after_update = false
-    end
-  CWINIT
-
-  inject_into_file "app/uploaders/image_uploader.rb",
-                   after: "class ImageUploader < CarrierWave::Uploader::Base\n" do
-    <<-RUBY.strip_heredoc.gsub(/^/, "  ")
-      # PaperTrail history support. CarrierWave's default behaviour wipes the
-      # previous file on update and reuses the same filename; PaperTrail only
-      # stores the column scalar, so a plain `version.reify; save!` restores a
-      # filename whose bytes are gone. The knobs below preserve every byte:
-      #
-      #   * `remove_previously_stored_files_after_update = false` is set
-      #     globally in config/initializers/carrierwave.rb (covers
-      #     `multi_image_field` uploaders too).
-      #   * `remove!` is a no-op so hard-destroyed records keep their files
-      #     and revert-after-destroy still finds the bytes on disk.
-      #   * `filename` is prefixed with a per-upload UUID so successive
-      #     uploads never collide on disk.
-      #
-      # Trade-off: files accumulate on disk; sweeping is out of scope.
-      # Source: https://stackoverflow.com/questions/9423279/papertrail-and-carrierwave
-      def remove!
-        # no-op: keep the file so PaperTrail revert can restore it.
-      end
-
-      def filename
-        # CarrierWave 3.x calls `filename` again after storing to record the
-        # persisted name; at that point `original_filename` may be nil and we
-        # must still return the memoized name (see
-        # https://github.com/carrierwaveuploader/carrierwave/issues/2708).
-        @name ||= "\#{secure_token}-\#{original_filename}" if original_filename
-        @name
-      end
-
-      private
-
-      def secure_token
-        var = :"@\#{mounted_as}_secure_token"
-        model.instance_variable_get(var) || model.instance_variable_set(var, SecureRandom.uuid)
-      end
-    RUBY
-  end
-
-  say "- Lower Photo.per_page so the seeded gallery paginates..."
-  # The model template (lib/generators/templates/model.erb) emits
-  #   attr_reader :per_page
-  #   @per_page = 7
-  # which is a long-standing typo: `attr_reader :per_page` defines an
-  # *instance* method, then `@per_page = 7` (executed in the class body)
-  # actively *clobbers* the class-level per_page that will_paginate
-  # exposes via `class_attribute :per_page` (its singleton-ivar storage
-  # also lives on `@per_page`). Net effect: nothing reads 7 anywhere,
-  # and the class-level per_page silently reverts to will_paginate's
-  # 30-default. Replace the pair on Photo with a real `self.per_page = 5`
-  # so the seeded gallery (12 photos) actually paginates 5/5/2.
-  gsub_file "app/models/photo.rb",
-            /^\s*attr_reader\s+:per_page\s*\n\s*@per_page\s*=\s*\d+\s*\n/,
-            "  self.per_page = 5\n"
-
-  run 'bundle exec rake db:migrate'
-
-  # Seed the photos gallery from a local `pics/` folder. The folder is
-  # *gitignored* in the gem source (so the built .gem stays small and
-  # the gallery images are not committed) which means GENERATOR_PATH/pics
-  # exists only when the installer is run from the source repo, not when
-  # it is run from an installed gem on the developer's box. We therefore
-  # check, in order:
-  #   1. ENV['INLINE_FORMS_SEED_PICS']  -- explicit override path
-  #   2. GENERATOR_PATH/pics            -- gem source repo checkout
-  #   3. /home/code/inline_forms/pics   -- local dev convention
-  # and copy whichever is found into the generated app's db/seed_images/.
-  # The migration generated below is what reads from db/seed_images at
-  # `db:migrate` / `db:test:prepare` time, so this copy is only ever a
-  # one-shot at app generation.
-  pics_candidates = [
-    ENV["INLINE_FORMS_SEED_PICS"],
-    File.join(GENERATOR_PATH, "pics"),
-    "/home/code/inline_forms/pics",
-  ].compact
-  pics_src = pics_candidates.find { |p| Dir.exist?(p) }
-  if pics_src
-    seed_pics = Dir.glob(File.join(pics_src, "*.{jpg,jpeg,JPG,JPEG,png,PNG,gif,GIF}")).sort
-    if seed_pics.any?
-      say "- Copying #{seed_pics.size} sample photo(s) into db/seed_images/..."
-      empty_directory "db/seed_images"
-      seed_pics.each do |abs|
-        copy_file abs, File.join("db/seed_images", File.basename(abs))
-      end
-
-      say "- Generating Konferensha apartment + photos seed migration..."
-      sleep 1 # unique migration timestamp
-      seed_ts = Time.now.utc.strftime("%Y%m%d%H%M%S")
-      create_file "db/migrate/#{seed_ts}_seed_konferensha_photos.rb", <<-SEED_MIGRATION.strip_heredoc
-        class SeedKonferenshaPhotos < ActiveRecord::Migration[7.1]
-          # Seed an Apartment with a gallery of photos so the nested
-          # has_many list (apartments -> photos) has enough rows to
-          # trigger pagination. Driven by db/seed_images/, which the
-          # inline_forms installer copies from the gem's pics/ dir.
-          # Runs in development (via db:migrate) and against the test
-          # DB (via db:test:prepare), so integration tests can assert
-          # the paginated <turbo-frame> renders without seeding manually.
-          def up
-            apartment = Apartment.find_or_create_by!(name: "Konferensha") do |a|
-              a.title = "Konferensha sobre Papiamentu"
-              a.opening_date = Date.new(2020, 5, 18)
-            end
-
-            seed_dir = Rails.root.join("db", "seed_images")
-            return unless seed_dir.directory?
-
-            Dir.glob(seed_dir.join("*.{jpg,jpeg,png,gif}"), File::FNM_CASEFOLD).sort.each do |abs|
-              base = File.basename(abs)
-              next if Photo.exists?(name: base, apartment_id: apartment.id)
-              File.open(abs, "rb") do |io|
-                Photo.create!(
-                  name: base,
-                  caption: "Konferensha foto \#{base}",
-                  apartment: apartment,
-                  image: io
-                )
-              end
-            end
-          end
-
-          def down
-            apartment = Apartment.find_by(name: "Konferensha")
-            return unless apartment
-            apartment.photos.destroy_all
-            apartment.destroy
-          end
-        end
-      SEED_MIGRATION
-
-      run "bundle exec rake db:migrate"
-    end
-  end
-
-  remove_file 'public/index.html'
-
-  say "- Apartment name list demo (field-level inline edit without _show)..."
-  inject_into_file "app/controllers/apartments_controller.rb",
-                   "\n  skip_load_and_authorize_resource only: :name_list\n\n  def name_list\n    authorize! :read, Apartment\n    @apartments = Apartment.accessible_by(current_ability).order(:id).limit(10)\n  end\n",
-                   after: "set_tab :apartment\n"
-
-  example_views_root = File.join(GENERATOR_PATH, "lib/installer_templates/example_app_views")
-  Dir.glob(File.join(example_views_root, "**", "*")).sort.each do |abs|
-    next unless File.file?(abs)
-    rel = abs.delete_prefix(example_views_root + File::SEPARATOR).tr("\\", "/")
-    create_file File.join("app/views", rel), File.read(abs)
-  end
-
-  route 'get "apartments/name_list", to: "apartments#name_list", as: :apartment_name_list'
-  route "root :to => 'apartments#index'"
-
-  say "- Adding example app regression tests (bundle exec rails test)..."
-  example_tests_root = File.join(GENERATOR_PATH, "lib/installer_templates/example_app_tests")
-  Dir.glob(File.join(example_tests_root, "**", "*.rb")).sort.each do |abs|
-    rel = abs.delete_prefix(example_tests_root + File::SEPARATOR).tr("\\", "/")
-    create_file rel, File.read(abs)
-  end
-
-  say "\nDone! Example app (Photo + Apartment) is ready.", :yellow
-  say "  bundle exec rails test     # example regression tests", :yellow
-  say "  bundle exec rails s        # then http://localhost:3000/apartments", :yellow
-  say "  More menu → Apartment names (first 10)  # /apartments/name_list", :yellow
-  say "  Log in: #{ENV["email"]} / #{ENV["password"]}", :yellow
-end
-# done!
-say "\nDone! Now make your tables with 'bundle exec rails g inline_forms ...", :yellow