card 1.104.2 → 1.105.0

data/lib/cardio/mod/eat/edibles.rb

@@ -27,14 +27,14 @@ module Cardio
 
         # @return [Array <Hash>]
         def mod_edibles mod
-          environments.map { |env| items_for_environment mod, env }.compact
+          pod_types.map { |type| items_for_type mod, type }.compact
         end
 
-        def items_for_environment mod, env
-          return unless (items = items_from_yaml mod, env)
+        def items_for_type mod, type
+          return unless (items = items_from_yaml mod, type)
 
           items = items.map do |item|
-            item.is_a?(String) ? items_from_yaml(mod, env, item) : item
+            item.is_a?(String) ? items_from_yaml(mod, type, item) : item
           end.flatten.compact
           interpret_items mod, items
         end
@@ -43,8 +43,8 @@ module Cardio
           each_card_hash(items) { |hash| handle_attachments mod, hash }
         end
 
-        def items_from_yaml mod, env, filename=nil
-          source = "#{env}#{'/' if filename.present?}#{filename}.yml"
+        def items_from_yaml mod, type, filename=nil
+          source = "#{type}#{'/' if filename.present?}#{filename}.yml"
           return unless (path = mod.subpath "data", source)
 
           YAML.load_file path
@@ -54,7 +54,7 @@ module Cardio
         def each_card_hash items
           items.each do |item|
             yield item
-            item[:subfields]&.values&.each { |val| yield val if val.is_a? Hash }
+            item[:fields]&.values&.each { |val| yield val if val.is_a? Hash }
           end
           items
         end
@@ -71,20 +71,27 @@ module Cardio
         end
 
         def mod_file mod, filename
-          File.open mod.subpath("data/files", filename)
+          unless (mod_file_path = mod.subpath "data/files", filename)
+            raise StandardError, "#{filename} not found. "\
+                                 "Should be in data/files in #{mod.name} mod."
+          end
+          File.open mod_file_path
         end
 
         def attachment_keys
           @attachment_keys ||= Card.uploaders.keys
         end
 
-        # @return [Array <Symbol>]
-        # holarchical. each includes the previous
-        # production = [:production],
-        # development = [:production, :development], etc.
-        def environments
-          index = DATA_ENVIRONMENTS.index(@env&.to_sym || Rails.env.to_sym) || -1
-          DATA_ENVIRONMENTS[0..index]
+        def pod_types
+          if @pod_type == :all
+            %i[real test]
+          elsif @pod_type
+            [@pod_type]
+          elsif Rails.env.test?
+            %i[real test]
+          else
+            [:real]
+          end
         end
       end
     end

data/lib/cardio/mod/eat.rb

@@ -1,8 +1,6 @@
 require "timecop"
+# require "pry"
 
-require "pry"
-
-DATA_ENVIRONMENTS = %i[production development test].freeze
 ENV["STORE_CODED_FILES"] = "true"
 
 module Cardio
@@ -11,25 +9,22 @@ module Cardio
     # (list of card attributes)
     # https://docs.google.com/document/d/13K_ynFwfpHwc3t5gnLeAkZJZHco1wK063nJNYwU8qfc/edit#
     class Eat
-      include Card::Model::SaveHelper
       include Edibles
 
-      def initialize mod: nil, env: nil, user: nil, verbose: nil
+      def initialize mod: nil, type: nil, user: nil, verbose: nil
         @mod = mod
-        @env = env
+        @pod_type = type&.to_sym
         @user_id = user&.card_id
         @verbose = !verbose.nil?
       end
 
       def up
-        Card::Cache.reset_all
-        Card::Mailer.perform_deliveries = false
-        Card::Auth.as_bot do
+        handle_up do
           edibles.each do |edible|
             track edible do
               current_user edible.delete(:user)
               time_machine edible.delete(:time) do
-                ensure_card edible
+                Card.ensure edible
               end
             end
           end
@@ -38,21 +33,30 @@ module Cardio
 
       private
 
+      # if output mod given,
+      def handle_up
+        Card::Cache.reset_all
+        Card::Mailer.perform_deliveries = false
+        Card::Auth.as_bot { yield }
+        :success
+      rescue StandardError => e
+        e.message
+      end
+
       def track edible
         rescuing edible do
-          # puts "eat: #{edible}" if @verbose
+          # puts "eating: #{edible}" if @verbose
           card = yield
-          puts "eaten: #{card.name}".green # if @verbose
+          puts "eaten: #{card.name}".cyan if @verbose
         end
       end
 
       def rescuing edible
         yield
       rescue StandardError => e
-        # binding.pry
         puts edible
         puts e.message.red
-        puts e.backtrace.join("\n") if @verbose
+        puts e.backtrace[0..10].join("\n") if @verbose
       end
 
       def current_user item_user

data/lib/cardio/mod/load_strategy/set_tmp_files.rb

@@ -9,7 +9,7 @@ module Cardio
           return unless prepare_tmp_dir "tmp/set"
 
           mod_dirs.each_with_tmp(:set) do |mod_dir, mod_tmp_dir|
-            Dir.mkdir mod_tmp_dir
+            FileUtils.mkdir_p mod_tmp_dir
             Dir.glob("#{mod_dir}/**/*.rb").each do |abs_path|
               rel_path = abs_path.sub "#{mod_dir}/", ""
               tmp_filename = File.join mod_tmp_dir, rel_path

data/lib/cardio/mod/load_strategy.rb

@@ -1,5 +1,15 @@
 module Cardio
   class Mod
+    # The main way to enhance cards' appearance and behavior is through the card set DSL.
+    #
+    # The default mechanism for loading DSL code is live evaluation, or Eval. Eval is
+    # fast and efficient and preferred for a wide range of scenarios, including
+    # production and live debugging. But Eval is problematic for generating both test
+    # coverage reports with Simplecov and documentation sites with YARD.
+    #
+    # For those two reasons, we make it possible to load the DSL code by generating
+    # fully explicit ruby modules in tmp files.
+    #
     # Shared code for the three different load strategies: Eval, TmpFiles and BindingMagic
     class LoadStrategy
       class << self
@@ -7,9 +17,9 @@ module Cardio
 
         def class_for_set strategy
           case strategy
-          when :tmp_files     then SetTmpFiles
+          when :tmp_files then SetTmpFiles
           when :binding_magic then SetBindingMagic
-          else                     Eval
+          else Eval
           end
         end
 

data/lib/cardio/mod/modfile_api.rb

@@ -2,26 +2,26 @@ module Cardio
   class Mod
     # Methods used via "eval" in Modfiles
     module ModfileApi
-      def mod mod_name, path=nil
-        @dirs.add_mod mod_name, path
+      def mod *args
+        @dirs.add_mod(*args)
       end
 
-      def gem_mod name
-        deps = Mod.dependencies name
-        unknown_gem_mod!(name) if deps.blank?
-        deps.each { |spec| @dirs.add_gem_mod spec.name, spec.full_gem_path }
-      end
-
-      # load all gem mods
-      def gem_mods
-        @dirs.load_from_gemfile
-      end
-
-      private
-
-      def unknown_gem_mod! name
-        raise Card::Error, %(Unknown gem "#{name}". Make sure it is in your Gemfile.)
-      end
+      # def gem_mod name
+      #   deps = Mod.dependencies name
+      #   unknown_gem_mod!(name) if deps.blank?
+      #   deps.each { |spec| @dirs.add_gem_mod spec.name, spec.full_gem_path }
+      # end
+      #
+      # # add all gem mods
+      # def gem_mods
+      #   @dirs.add_from_gemfile
+      # end
+      #
+      # private
+      #
+      # def unknown_gem_mod! name
+      #   raise Card::Error, %(Unknown gem "#{name}". Make sure it is in your Gemfile.)
+      # end
     end
   end
 end

data/lib/cardio/mod/{poop.rb → sow.rb}

@@ -1,18 +1,15 @@
 module Cardio
   class Mod
-    # POOP (or Plain Old OutPut) is our nickname for our standard card YAML,
-    # used to define cards associated with mods.
-    #
-    # Monkeys throw it around, and Sharks can eat it (if you believe this guy:
-    # https://www.youtube.com/watch?v=VvEa4NSqw7I).
+    # The Sow class is for exporting data to mods' data directories so that they can
+    # be used as seed data when the mod is installed.
     #
     # https://docs.google.com/document/d/13K_ynFwfpHwc3t5gnLeAkZJZHco1wK063nJNYwU8qfc/edit#
-    class Poop
+    class Sow
       def initialize **args
         @mod = args[:mod]
         @name = args[:name]
         @cql = args[:cql]
-        @env = args[:env] || Rails.env
+        @env = args[:env] || (Rails.env.test? ? :test : :production)
         @items = args[:items]
         @field_tags = args[:field_tags]
       end
@@ -65,17 +62,14 @@ module Cardio
 
       def cards_from_name
         case @items
-        when :only
-          item_cards
-        when true
-          main_cards + item_cards
-        else
-          main_cards
+        when :only then item_cards
+        when true  then main_cards + item_cards
+        else            main_cards
         end
       end
 
       def item_cards
-        main_cards.map { |mc| mc.item_cards }.flatten
+        main_cards.map(&:item_cards).flatten
       end
 
       def main_cards
@@ -116,13 +110,11 @@ module Cardio
       end
 
       def target
-        @target ||= old_data
+        @target ||= (old_data || nil)
       end
 
       def old_data
-        return nil unless File.exist? filename
-
-        YAML.safe_load File.read(filename), [Symbol]
+        YAML.safe_load File.read(filename), [Symbol] if File.exist? filename
       end
 
       # @return Path

data/lib/cardio/mod.rb

@@ -10,17 +10,16 @@ module Cardio
   #
   #     decko generate card:mod MOD_NAME
   #
-  # This will create the following directories:
+  # This will create a directory following the pattern `DECK_NAME/mod/MOD_NAME`. This
+  # directory contains all the specifications of your mod. By default that includes
+  # a README.md file and the following subdirectories:
   #
-  #     DECK_NAME/mod/MOD_NAME
-  #     DECK_NAME/mod/MOD_NAME/lib
-  #     DECK_NAME/mod/MOD_NAME/public
-  #     DECK_NAME/mod/MOD_NAME/set
-  #
-  # The lib directory contains libraries, of course. And files in the public directory
-  # are public and served directly.
-  #
-  # But in most mods, the focal point is the *set* directory.
+  # - **assets** - for JavaScript, CSS, and variants (CoffeeScript, SCSS, etc)
+  # - **data** - for seed and test data. see {file:SEEDME.md}.
+  # - **lib** - for standard code libraries
+  # - **public** - accessible via the web at DECK_URL_ROOT/mod/MOD_NAME/
+  # - **set** - the mod's focal point where card sets are configured (see below)
+  # - **spec** - for rspec tests
   #
   # ## Set Modules
   #
@@ -64,16 +63,17 @@ module Cardio
   class Mod
     extend ClassMethods
 
-    attr_reader :name, :path, :index
+    attr_reader :name, :path, :group, :index
 
-    def initialize name, path, index
+    def initialize name, path, group, index
       @name = Mod.normalize_name name
       @path = required_path path
+      @group = group || :custom
       @index = index
     end
 
     def mod_card_name
-      "mod: #{name}"
+      "mod: #{name.tr '_', ' '}"
     end
 
     def codename
@@ -86,16 +86,17 @@ module Cardio
     end
 
     def tmp_dir type
-      File.join Cardio.paths["tmp/#{type}"].first,
+      File.join Cardio.paths["tmp/#{type}"].first, @group.to_s,
                 "mod#{'%03d' % (@index + 1)}-#{@name}"
     end
 
-    def ensure
-      Card::Auth.as_bot do
-        card = ensure_card
-        card.ensure_mod_script_card
-        card.ensure_mod_style_card
-        Card::Cache.reset_all
+    def ensure_card
+      if Card::Codename.exists? codename
+        card = Card.fetch codename.to_sym
+        card.update type: :mod unless card.type_code == :mod
+        card
+      else
+        Card.create name: mod_card_name, type: :mod, codename: codename
       end
     end
 
@@ -106,15 +107,5 @@ module Cardio
 
       raise Card::Error::NotFound, "mod not found: #{@name}"
     end
-
-    def ensure_card
-      if Card::Codename.exists? codename
-        card = Card.fetch codename.to_sym
-        card.update type: :mod unless card.type_code == :mod
-        card
-      else
-        Card.create name: mod_card_name, type: :mod, codename: codename
-      end
-    end
   end
 end

data/lib/cardio/railtie.rb

@@ -1,67 +1,30 @@
 module Cardio
   # primary railtie for cards
   class Railtie < Rails::Railtie
+    config.encoding = "utf-8"
+
+    config.seed_mods = [:core]
+    config.seed_type = :real
+    config.extra_seed_tables = []
+
     # if you disable inline styles tinymce's formatting options stop working
     config.allow_inline_styles = true
     config.token_expiry = 2.days
 
-    config.recaptcha_public_key = nil  # deprecated; use recaptcha_site_key instead
-    config.recaptcha_private_key = nil # deprecated; use recaptcha_secret_key instead
-
-    config.recaptcha_proxy = nil
-    config.recaptcha_site_key = nil
-    config.recaptcha_secret_key = nil
-    config.recaptcha_minimum_score = 0.5
-
-    config.google_analytics_key = nil
-    config.google_analytics_tracker_key = nil
-    config.google_analytics_four_key = nil
-
     config.no_authentication = false
-    config.files_web_path = "files"
 
     config.max_char_count = 200
     config.max_depth = 20
     config.email_defaults = nil
 
-    config.acts_per_page = 10
     config.space_last_in_multispace = true
-    config.closed_search_limit = 10
-    config.paging_limit = 20
-
-    config.delaying = false
-    config.active_job.queue_adapter = :delayed_job
-
-    config.non_createable_types = %w[
-      signup
-      setting
-      set
-      session
-      bootswatch_skin
-      customized_bootswatch_skin
-      local_folder_group
-      local_manifest_group
-      local_script_folder_group
-      local_script_manifest_group
-      local_style_folder_group
-      local_style_manifest_group
-      remote_manifest_group
-      mod
-    ]
 
     config.view_cache = false
-    config.rss_enabled = false
-    config.double_click = :signed_in
 
-    config.encoding = "utf-8"
     config.request_logger = false
     config.performance_logger = false
     config.sql_comments = false
 
-    config.file_storage = :local
-    config.file_buckets = {}
-    config.file_default_bucket = nil
-
     config.deck_origin = nil
 
     config.rich_text_editor = :tinymce
@@ -74,13 +37,12 @@ module Cardio
     config.allow_irreversible_admin_tasks = false
     config.raise_all_rendering_errors = false
     config.rescue_all_in_controller = true
-    config.navbox_match_start_only = true
 
     config.cache_set_module_list = false
 
     config.i18n.enforce_available_locales = true
     config.read_only = !ENV["DECKO_READ_ONLY"].nil?
-    config.load_strategy = (ENV["REPO_TMPSETS"] || ENV["TMPSETS"] ? :tmp_files : :eval)
+    config.load_strategy = ENV["CARD_LOAD_STRATEGY"]&.to_sym || :eval
 
     # TODO: support mod-specific railties
 
@@ -98,8 +60,7 @@ module Cardio
 
           p["lib/tasks"] << "#{card_root}/lib/tasks"
 
-          p.add "mod", with: "#{card_root}/mod"
-          p["mod"] << "mod"
+          p.add "mod"
           p.add "files"
 
           p.add "lib/graph_q_l/types/query.rb"
@@ -113,7 +74,7 @@ module Cardio
           p.add "db/migrate_deck", with: "db/migrate"
           p.add "db/migrate_deck_cards", with: "db/migrate_cards"
 
-          Cardio::Mod.each_path do |mod_path|
+          Cardio::Mod.dirs.each do |mod_path|
             c.autoload_paths += Dir["#{mod_path}/lib"]
             c.watchable_dirs["#{mod_path}/set"] = %i[rb haml]
 
@@ -121,11 +82,12 @@ module Cardio
               "#{mod_path}/lib/graph_q_l/types/query.rb"
             p["config/initializers"] << "#{mod_path}/init/early"
             p["late/initializers"] << "#{mod_path}/init/late"
-            p["config/locales"] << "#{mod_path}/locales"
             p["lib/tasks"] << "#{mod_path}/lib/tasks"
             p["mod-data"] << "#{mod_path}/data"
+            p["config/locales"] << "#{mod_path}/locales"
           end
 
+          # Card doesn't use these rails patterns
           p["app/models"] = []
           p["app/mailers"] = []
           p["app/controllers"] = []
@@ -136,15 +98,16 @@ module Cardio
     config.before_initialize do |app|
       app.config.tap do |c|
         if c.load_strategy == :tmp_files
-          %w[set set_pattern].each do |dir|
-            if ENV["REPO_TMPSETS"]
-              c.paths.add "tmp/#{dir}", with: "#{Cardio.gem_root}/tmpsets/#{dir}"
-            else
-              c.paths.add "tmp/#{dir}"
-            end
-          end
+          %w[set set_pattern].each { |dir| c.paths.add "tmp/#{dir}" }
         end
       end
     end
+
+    def self.require_mod_gem mod_name
+      require mod_name.name.to_s.tr("-", "/")
+    rescue LoadError
+    end
+
+    Cardio::Mod.gem_specs.each_value { |mod_name| require_mod_gem mod_name }
   end
 end

data/lib/cardio/schema.rb

@@ -31,7 +31,8 @@ module Cardio
       end
 
       def version type=nil
-        File.read(stamp_path(type)).strip
+        path = stamp_path type
+        File.exist?(path) ? File.read(path).strip : nil
       end
 
       def stamp_path type

data/lib/cardio/script_loader.rb

@@ -8,8 +8,10 @@ module Cardio
       RUBY = File.join(*RbConfig::CONFIG.values_at("bindir", "ruby_install_name")) +
              RbConfig::CONFIG["EXEEXT"]
 
+      attr_accessor :script_name
+
       def script
-        File.join("script", "card")
+        File.join "script", script_name
       end
 
       def exec!

data/lib/cardio/seed.rb

@@ -6,16 +6,109 @@ module Cardio
                 schema_migrations_deck schema_migrations_deck_cards].freeze
 
     class << self
-      attr_accessor :path, :test_path, :test_script_path
+      def default_path
+        db_path Cardio.config.seed_type, 0
+      end
 
-      def db_path *args
-        parts = [Cardio.gem_root, "db"] + args
-        File.join(*parts)
+      def path
+        if update_seed?
+          db_path :real, (Rails.env.test? ? 0 : 1)
+        else
+          default_path
+        end
+      end
+
+      def load
+        ActiveRecord::FixtureSet.create_fixtures path, load_tables
+
+        return unless update_seed?
+
+        Cardio::Migration.assume_current
+        Cardio::Migration::Core.assume_current
+        Cardio::Migration::DeckStructure.assume_current
+        # Cardio::Migration::Core.assume_current
+      end
+
+      def dump
+        dump_tables.each do |table|
+          i = "000" # TODO: use card keys instead (this is just a label)
+          write_seed_file table do
+            yamlize_records table do |record, hash|
+              hash["#{table}_#{i.succ!}"] = record
+            end
+          end
+        end
+      end
+
+      def clean
+        Card::Act.update_all actor_id: author_id
+        clean_history
+        clean_time_and_user_stamps
+      end
+
+      private
+
+      def update_seed?
+        ENV["CARD_UPDATE_SEED"]
+      end
+
+      # TODO: make this more robust. only handles simple case of extra seed tables
+      def load_tables
+        update_seed? && !Rails.env.test? ? TABLES : dump_tables
+      end
+
+      def dump_tables
+        TABLES + Cardio.config.extra_seed_tables
       end
-    end
 
-    self.path = db_path "seed", "new"
-    self.test_path = db_path "seed", "test", "fixtures"
-    self.test_script_path = db_path "test_seed.rb"
+      def db_path env, index
+        Mod.fetch(Cardio.config.seed_mods[index]).subpath "data", "fixtures", env.to_s
+      end
+
+      def write_seed_file table
+        filename = File.join default_path, "#{table}.yml"
+        File.open(filename, "w") { |file| file.write yield }
+      end
+
+      def yamlize_records table
+        data = ActiveRecord::Base.connection.select_all "select * from #{table}"
+        YAML.dump(
+          data.each_with_object({}) do |record, hash|
+            try "clean_#{table}_record", record
+            yield record, hash
+          end
+        )
+      end
+
+      def clean_card_actions_record record
+        record["draft"] = false # needed?
+      end
+
+      def clean_card_record record
+        record["trash"] = false # needed?
+        %w[created_at updated_at current_revision_id references_expired].each do |key|
+          record.delete key
+        end
+      end
+
+      def clean_history
+        puts "clean history"
+        act = Card::Act.create! actor_id: author_id, card_id: author_id
+        Card::Action.make_current_state_the_initial_state act
+        Card::Act.where("id <> #{act.id}").delete_all
+        ActiveRecord::Base.connection.execute("truncate sessions")
+      end
+
+      def clean_time_and_user_stamps
+        puts "clean time and user stamps"
+        conn = ActiveRecord::Base.connection
+        conn.update "UPDATE cards SET creator_id=#{author_id}, updater_id=#{author_id}"
+        conn.update "UPDATE card_acts SET actor_id=#{author_id}"
+      end
+
+      def author_id
+        Card::WagnBotID
+      end
+    end
   end
 end