[SF Ruby #7] Forms on Rails

Transcript

1. FORMS ON RAILS Vladimir Dementyev Evil Martians SF Bay Area

   Ruby #7

2. UI FORM RUBY ON RAILS

3. <%= form_for @cable do |f| %> <%= f.text_field :name, required:

   true %> <%= f.text_field :region, required: true %> <%= f.radio_button :framework, "rails" %> <%= f.radio_button :framework, "js" %> <%= f.radio_button :framework, "hotwire" %> <%= f.radio_button :framework, "default" %> <%= f.text_field :rpc_host %> <%= f.text_field :rpc_secret %> <%= f.text_field :secret %> <%= f.text_field :turbo_secret %> <%= f.text_field :jwt_secret %> <%= f.submit "Create" %> <% end %>

4. <%= form_for @cable do |f| %> <%= f.text_field :name %>

   # ??? # ??? # ??? # ??? <% end %>

5. RAILS WAY

6. Rails Way Model Controller View Request Response

7. Rails Way+ Model Controller View Request Response ???

8. Rails Way+ Model Controller View Form Object Request Response

9. SEPARATE CONCERNS * without using Rails Concerns !

10. Form Object: concerns — Context-specific validations — User input transformation

    — User feedback — Custom UI-driven logic (like wizards)

11. FORMS FROM THE PAST

12. None
13. None

14. Reform class AlbumForm < Reform::Form property :title validates :title, presence:

    true property :artist do property :name validates :name, presence: true end end

15. Reform class AlbumsController < ApplicationController def new @form = AlbumForm.new(Album.new)

    end end
16. None
17. None

18. LIGHTS! ACTION! FORM! * or Action Form I'm happy with

    "
19. None
20. None

21. class Cable class CreateForm < ApplicationForm self.model_name = "Cable" attribute

    :name attribute :region, default: -> { "sea" } attribute :framework, default: -> { "rails" } attributes :secret, :rpc_host, :rpc_secret, :turbo_secret, :jwt_secret attr_reader :cable def initialize(...) super @cable = Cable.new( name:, region:, metadata: {framework:}, configuration: { secret:, rpc_host:, rpc_secret:, turbo_secret:, jwt_secret: } ) end def submit! = cable.save! end end

22. class Cable class CreateForm < ApplicationForm self.model_name = "Cable" attribute

    :name attribute :region, default: -> { "sea" } attribute :framework, default: -> { "rails" } attributes :secret, :rpc_host, :rpc_secret, :turbo_secret, :jwt_secret attr_reader :cable def initialize(...) super @cable = Cable.new( name:, region:, metadata: {framework:}, configuration: { secret:, rpc_host:, rpc_secret:, turbo_secret:, jwt_secret: } ) end def submit! = cable.save! end end UI / schema decoupling

23. class Cable class CreateForm < ApplicationForm self.model_name = "Cable" attribute

    :name attribute :region, default: -> { "sea" } attribute :framework, default: -> { "rails" } attributes :secret, :rpc_host, :rpc_secret, :turbo_secret, :jwt_secret validates :name, :region, presence: true validates :rpc_host, format: %r{\Ahttps?://}, allow_blank: true attr_reader :cable def initialize(...) # ... end def submit! = cable.save! end end Validations?

24. class Cable class CreateForm < ApplicationForm self.model_name = "Cable" attribute

    :name attribute :region, default: -> { "sea" } attribute :framework, default: -> { "rails" } attributes :secret, :rpc_host, :rpc_secret, :turbo_secret, :jwt_secret validates :cable_is_valid validates :rpc_host, format: %r{\Ahttps?://}, allow_blank: true attr_reader :cable def initialize(...) # ... end def submit! = cable.save! private def cable_is_valid return if cable.valid? merge_errors!(cable) end end end Validations: a) model delegation b) context-specific

25. class Cable class CreateForm < ApplicationForm self.model_name = "Cable" attribute

    :name attribute :region, default: -> { "sea" } attribute :framework, default: -> { "rails" } attributes :secret, :rpc_host, :rpc_secret, :turbo_secret, :jwt_secret validates :cable_is_valid validates :rpc_host, format: %r{\Ahttps?://}, allow_blank: true after_commit :enqueue_provisioning attr_reader :cable def initialize(...) # ... end def submit! = cable.save! private def enqueue_provisioning = cable.provision_later end end Trigger business operations

26. class Cable class CreateForm < ApplicationForm self.model_name = "Cable" attribute

    :name attribute :region, default: -> { "sea" } attribute :framework, default: -> { "rails" } attributes :secret, :rpc_host, :rpc_secret, :turbo_secret, :jwt_secret validates :cable_is_valid validates :rpc_host, format: %r{\Ahttps?://}, allow_blank: true after_commit :enqueue_provisioning attr_reader :cable def initialize(...) # ... end def submit! = cable.save! private def enqueue_provisioning = cable.provision_later end end What is this?

27. –DHH, The Rails Way, 1st edition “...work with the framework,

    not against it.”

28. — Learn Rails building blocks and re-use them — Agree

    to the overachieving principle of conventions — Make your code play nicely with other Rails components

29. class ApplicationForm include ActiveModel::API include ActiveModel::Attributes define_callbacks :save, only: :after

    define_callbacks :commit, only: :after def save return false unless valid? with_transaction do AfterCommitEverywhere.after_commit { run_callbacks(:commit) } run_callbacks(:save) { submit! } end end def model_name ActiveModel::Name.new(nil, nil, self.class.name.sub(/Form$/, "")) end private def with_transaction(&) = ApplicationRecord.transaction(&) def submit! raise NotImplementedError end end Validations / Types Callbacks Transactions awareness Interface Action View compat

30. class CablesController < ApplicationController def new authorize! @cable = Cable.new

    end def create authorize! @cable = Cable.new(cable_params) if @cable.save redirect_to cable_path(@cable), notice: "Success!" else render :new, status: :unprocessable_entity end end end

31. class CablesController < ApplicationController def new authorize! @form = Cable::CreateForm.new

    end def create authorize! @form = Cable::CreateForm.from(params.require(:cable)) if @form.save redirect_to cable_path(@form.cable), notice: "Success!" else render :new, status: :unprocessable_entity end end end

32. <%= form_for @cable do |f| %> <%= f.text_field :name, required:

    true %> <%= f.text_field :region, required: true %> # ... <%= f.submit "Create" %> <% end %> <form action="/cables" method="post"> <input type="text" name="cable[name]" required> <input type="text" name="cable[region]" required> <!-- ... --> <input type="submit" value="Create"> </form>

33. <%= form_for form do |f| %> <%= f.text_field :name, required:

    true %> <%= f.text_field :region, required: true %> # ... <%= f.submit "Create" %> <% end %> <form action="/cables" method="post"> <input type="text" name="cable[name]" required> <input type="text" name="cable[region]" required> <!-- ... --> <input type="submit" value="Create"> </form> self.model_name = "Cable"

34. SEND IN THE WIZARDS!

35. — Now the form logic has its own home in

    the application — We can localize changes related to this feature and iterate faster

36. Wizard is a DFA

37. gem "workflow" https://github.com/geekq/workflow

38. class Cable class CreateForm < ApplicationForm class Wizard < ApplicationWorkflow

    workflow do state :name do event :submit, transitions_to: :framework end state :framework do event :submit, transitions_to: :rpc, if: :needs_rpc? event :submit, transitions_to: :secrets event :back, transitions_to: :name end state :rpc do event :submit, transitions_to: :secrets event :back, transitions_to: :framework end state :secrets do event :submit, transitions_to: :region event :back, transitions_to: :rpc, if: :needs_rpc? event :back, transitions_to: :framework end state :complete end end end end

39. class Cable class CreateForm < ApplicationForm class Wizard < ApplicationWorkflow

    # ... end attribute :wizard_state, default: -> { "name" } attribute :wizard_action def submit! if wizard_action == "back" wizard.back! else wizard.submit! end return false unless wizard.complete? cable.save! end def wizard = @wizard ||= Wizard.new(self) end end

40. class CablesController < ApplicationController def new authorize! @form = Cable::CreateForm.new

    end def create authorize! @form = Cable::CreateForm.from(params.require(:cable)) if @form.save redirect_to cable_path(@form.cable), notice: "Success!" else status = @form.valid? ? :created : :unprocessable_entity render :new, status: end end end

41. <%= form_for form do |f| %> <%= f.hidden_field :wizard_state %>

    <% if form.wizard.name? %> <%= f.text_field :name %> <% else %> <%= f.hidden_field :name %> <% end %>

42. <%= form_for form do |f| %> <%= f.hidden_field :wizard_state %>

    # ... <% if form.wizard.framework? %> <%= f.radio_button :framework, "rails" %> <%= f.radio_button :framework, "js" %> <%= f.radio_button :framework, "hotwire" %> <%= f.radio_button :framework, "default" %> <% else %> <%= f.hidden_field :framework %> <% end %>

43. <% if form.wizard.prerequisites? %> # ... <% end %> <%=

    form_for form do |f| %> <%= f.hidden_field :wizard_state %> # ...

44. <% if form.wizard.rpc? %> <%= f.text_field :rpc_host %> <% else

    %> <%= f.hidden_field :rpc_host %> <% end %> <%= form_for form do |f| %> <%= f.hidden_field :wizard_state %> # ...

45. <% if form.wizard.secrets? %> <%= f.text_field :secret %> <% else

    %> <%= f.hidden_field :secret %> <% end %> <%= form_for form do |f| %> <%= f.hidden_field :wizard_state %> # ...

46. <% if form.wizard.can_complete? %> <%= f.submit "Create" %> <% else

    %> <%= f.submit "Next", formaction: new_cable_path %> <% end %> <% if form.wizard.can_back? %> <%= f.submit "Back", formaction: new_cable_path, value: "Back", name: "cable[wizard_action]" %> <% end %> <% end %> <%= form_for form do |f| %> <%= f.hidden_field :wizard_state %> # ...

47. YOU DON'T NEED TO BE A WIZARD TO BUILD A

    WIZARD

48. THANK YOU Vladimir Dementyev Evil Martians SF Bay Area Ruby

    #7