Class: FactoryBot::Instrumentation::RootController

Inherits:
ApplicationController show all
Defined in:
app/controllers/factory_bot/instrumentation/root_controller.rb

Overview

The Instrumentation engine controller with frontend and API actions.

Instance Method Summary collapse

Methods inherited from ApplicationController

#basic_auth, #groups, #instrumentation, #scenario_group, #scenarios

Instance Method Details

#create ⇒ Object

Create a new entity with the given factory settings to create on demand dependencies for your testing needs. You can pass in requests without authentication in the following JSON format:

{
  "factory": "user",
  "traits": ["confirmed"],
  "overwrite": {
    "first_name": "Bernd",
    "last_name": "Schulze",
    "email": "[email protected]",
    "password": "secret"
  }
}

The result is the API v1 representation of the created entity.



33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'app/controllers/factory_bot/instrumentation/root_controller.rb', line 33

def create
  # Reload the factories to improve the test development experience.
  # In parallel request conditions this may lead to +Factory already
  # registered+ errors as this call is not thread safe as it seems,
  # so we retry it multiple times.
  with_retries(max_tries: 15) { FactoryBot.reload }
  # Call the factory construction with the user given parameters
  entity = FactoryBot.create(*factory_params)
  # Render the resulting entity with the configured rendering block
  FactoryBot::Instrumentation.configuration.render_entity.call(
    self, entity
  )
rescue StandardError => e
  # Handle any error gracefully with the configured error handler
  FactoryBot::Instrumentation.configuration.render_error.call(self, e)
end

#factory_params ⇒ Array<Mixed>

Parse the given parameters from the request and build a valid FactoryBot options set.



54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
 
# File 'app/controllers/factory_bot/instrumentation/root_controller.rb', line 54

def factory_params
  data = params.permit(:factory, traits: [])

  overwrite = if Rails::VERSION::MAJOR >= 5
                params.to_unsafe_h.fetch(:overwrite, {})
                      .deep_symbolize_keys
              else
                params.fetch('overwrite', {}).deep_symbolize_keys
              end

  [
    data.fetch(:factory).to_sym,
    *data.fetch(:traits, []).map(&:to_sym),
    { **overwrite }
  ]
end

#index ⇒ Object

Show the instrumentation frontend which features the output of configured dynamic seeds scenarios. The frontend allows humans to generate new seed data on the fly.



10
11
12
13
14
15
 
# File 'app/controllers/factory_bot/instrumentation/root_controller.rb', line 10

def index
  @instrumentation = instrumentation
  @scenarios = scenarios
  @config = FactoryBot::Instrumentation.configuration
  render :index, layout: true
end