better_seeder 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d791cd07db093b5651fff8ee43c8a9b04360efd6ad7aaa83978f9233f53f7a2
-  data.tar.gz: 4b4ca980a85b832b9261750db2742a89f61a18bc6a33f253a6486076a9a572ea
+  metadata.gz: d0703abc9a90ae9676b1c1d79553345e09e148b0c5411740779b1157c4d6cbdd
+  data.tar.gz: 1e0966ba4ea675cfdd6b6a28b8bae9457770957251272be352ed44e7db0d2b2b
 SHA512:
-  metadata.gz: 765e67ac2cac0af3e1b3a443f9896ce1212a0a6e0e6815b4bd7e7e148f75aabab3b6da279f2b5dc32c5a070c02024567524e175c710a5604e297221aa70157e8
-  data.tar.gz: a87f473eb71a6156dfdb829435323b67bcfe5645ebb30e32143071ba94107cdd99d730452032b6360c870212967d4d8e8c8b4f6fb496d6ba723384aa1e52e03e
+  metadata.gz: 83d3b209222d0a44824c7795a2ca3b041177e7d01d12277d89a3c5b39fd194157da4764e9d6a185759348c74d8d0bc10b6a2ac3587fcb607cdc5711d87bd339a
+  data.tar.gz: e11c9bf4bc617d3d588464eb0661811bfd198d8ccf9188421c95eff5437117f50ee542f3a894cff50bb99a3709d0211d8a822c708034588517bea6d4eddf2420

data/README.md

@@ -199,6 +199,69 @@ This command processes each model by:
 
 ---
 
+## Structure Generator
+
+`BetterSeeder.generate_structure(model_name: 'MyModel')` method. This functionality automatically creates a structure file template for a given model name. The generated file is saved in the appropriate subdirectory under `db/seed/structure` and includes placeholders for attribute generators, a validation schema, seed configuration, and uniqueness constraints.
+
+### How to Use
+
+Simply call the method with your model name. For example:
+
+```ruby
+BetterSeeder.generate_structure(model_name: 'MyNamespace::MyModel')
+```
+
+This command will generate a file at `db/seed/structure/my_namespace/my_model_structure.rb`.
+
+### Example Generated File
+
+The generated file will contain a template similar to the following:
+
+```ruby
+module MyNamespace
+  class MyModelStructure < BetterSeeder::StructureBase
+    # Defines generators for each attribute.
+    def self.structure
+      {
+        attribute_name: [:string, -> { "your value" }]
+      }
+    end
+
+    # Optional: Validate generated records using Dry-schema.
+    def self.seed_schema
+      Dry::Schema.Params do
+        required(:attribute_name).filled(:string)
+      end
+    end
+
+    # Specific seeding configuration for MyModel.
+    def self.seed_config
+      {
+        file_name: 'my_model_seed',
+        columns: { excluded: [] },
+        generate_data: true,
+        count: 10,
+        load_data: true,
+        parent: nil
+      }
+    end
+
+    # Optional: Uniqueness constraints.
+    def self.unique_keys
+      []
+    end
+  end
+end
+```
+
+### Benefits
+
+- **Automated Scaffolding:** Quickly generate a complete structure file template for any model.
+- **Consistency:** All generated files adhere to a standard format, ensuring consistency across your seeding logic.
+- **Customization:** Easily modify the generated file to fine-tune attribute generators, validation rules, seeding configuration, and uniqueness constraints.
+
+---
+
 ## Conclusion
 
 BetterSeeder provides a modular, configurable, and extensible system for seeding your Rails application's data:

data/lib/better_seeder/{generators/data_generator.rb → farms/farmer.rb}

@@ -1,6 +1,6 @@
 module BetterSeeder
-  module Generators
-    class DataGenerator
+  module Farms
+    class Farmer
       # Genera dati fittizi per il modello specificato utilizzando il file di structure.
       #
       # Opzioni attese (Hash):

data/lib/better_seeder/generators/structure.rb

@@ -0,0 +1,79 @@
+# lib/better_seeder/generators/structure_generator.rb
+require 'fileutils'
+
+module BetterSeeder
+  module Generators
+    class Structure
+      TEMPLATE = <<~RUBY
+        module %{module_name}
+          class %{class_name}Structure < ::BetterSeeder::Structure::Utils
+            # Defines generators for each attribute.
+            def self.structure
+              {
+                # Replace with your attribute generators:
+                attribute_name: [:string, -> { "your value" }]
+              }
+            end
+
+            # Optional: Validate generated records using Dry-schema.
+            def self.seed_schema
+              Dry::Schema.Params do
+                # Replace with your validations:
+                required(:attribute_name).filled(:string)
+              end
+            end
+
+            # Specific seeding configuration for %{class_name}.
+            def self.seed_config
+              {
+                file_name: '%{file_name}',
+                columns: { excluded: [] },
+                generate_data: true,
+                count: 10,
+                load_data: true,
+                parent: nil
+              }
+            end
+
+            # Optional: Uniqueness constraints.
+            def self.unique_keys
+              []
+            end
+          end
+        end
+      RUBY
+
+      # Generates a structure file for the given model name.
+      #
+      # @param model_name [String] The full model name (e.g., "MyNamespace::MyModel")
+      # @return [String] The full path to the generated file.
+      def self.generate(model_name)
+        # Split the model name into module parts and the actual class name.
+        parts = model_name.split("::")
+        class_name = parts.pop
+        module_name = parts.empty? ? "Main" : parts.join("::")
+
+        # Determine the file path.
+        # For example, for "MyNamespace::MyModel", the file will be placed in:
+        # lib/better_seeder/generators/my_namespace/my_model_structure.rb
+        folder_path = File.join(BetterSeeder.configuration.structure_path, *parts.map(&:underscore))
+        file_name = "#{class_name.underscore}_structure.rb"
+        full_path = File.join(folder_path, file_name)
+
+        # Ensure the target directory exists.
+        FileUtils.mkdir_p(folder_path) unless Dir.exist?(folder_path)
+
+        # Prepare the file content.
+        content = TEMPLATE % {
+          module_name: module_name,
+          class_name: class_name,
+          file_name: "#{class_name.underscore}_seed"
+        }
+
+        # Write the template to the file.
+        File.write(full_path, content)
+        full_path
+      end
+    end
+  end
+end

data/lib/better_seeder/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BetterSeeder
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/better_seeder.rb

@@ -1,7 +1,7 @@
 require_relative "better_seeder/utils"
 require_relative "better_seeder/configuration"
 require_relative "better_seeder/structure/utils"
-require_relative "better_seeder/generators/data_generator"
+require_relative "better_seeder/farms/farmer"
 require_relative "better_seeder/exporters/base"
 require_relative "better_seeder/exporters/json"
 require_relative "better_seeder/exporters/csv"
@@ -109,6 +109,10 @@ module BetterSeeder
     log_statistics(stats, total_time)
   end
 
+  def self.generate_structure(model_name: )
+    BetterSeeder::Generators::Structure.generate(model_name)
+  end
+
   private
 
   # Processa la configurazione per un singolo modello.
@@ -167,7 +171,7 @@ module BetterSeeder
 
     # Recupera o genera i record.
     records = if generate_data
-                Generators::DataGenerator.generate(model: model_name, count: count)
+                Farms::Farmer.generate(model: model_name, count: count)
               else
                 model_class.all.map(&:attributes)
               end

data/lib/generators/better_seeder/structure_generator/structure_generator.rb

@@ -0,0 +1,19 @@
+# lib/generators/better_seeder/structure_generator/structure_generator.rb
+require 'rails/generators'
+require 'better_seeder'
+
+module BetterSeeder
+  module Generators
+    class StructureGenerator < Rails::Generators::NamedBase
+      # No template file is needed as our method generates the file content.
+      # Instead, we call the BetterSeeder.generate_structure method.
+      def create_structure_file
+        say_status("info", "Generating structure file for #{name}", :green)
+        # Call the generator method from your gem.
+        # It expects a keyword argument :model_name.
+        file_path = BetterSeeder.generate_structure(model_name: name)
+        say_status("info", "Structure file created at #{file_path}", :green)
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: better_seeder
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - alessio_bussolari
@@ -70,28 +70,28 @@ dependencies:
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '4.2'
 - !ruby/object:Gem::Dependency
@@ -138,10 +138,12 @@ files:
 - lib/better_seeder/exporters/csv.rb
 - lib/better_seeder/exporters/json.rb
 - lib/better_seeder/exporters/sql.rb
-- lib/better_seeder/generators/data_generator.rb
+- lib/better_seeder/farms/farmer.rb
+- lib/better_seeder/generators/structure.rb
 - lib/better_seeder/structure/utils.rb
 - lib/better_seeder/utils.rb
 - lib/better_seeder/version.rb
+- lib/generators/better_seeder/structure_generator/structure_generator.rb
 homepage: https://github.com/alessiobussolari/better_seeder
 licenses:
 - MIT