Dry::Struct::Setters is an extension to the Dry::Struct library. Subclasses of Dry::Struct only define getter methods for its attributes by design (or preference). This library extends subclasses so they also provide setter methods.
By including the Dry::Struct::Setters module into your Dry::Struct subclass every defined attribute will get a corresponding setter method:
module Types include ::Types.module end class Project < :: include :::: attribute :name, Types::String end project = Project.new(name: 'some-project') project.name = 'some-project-new' project.name # => 'some-project-new'
Including the Dry::Struct::Setters module into you Dry::Struct subclass will only define setter methods, mass assigning attributes won't work with this. If you want to be able to mass assign attributes, just include the Dry::Struct::Setters::MassAssignment module, which will provide an assign_attributes method:
module Types include ::Types.module end class Project < :: include :::: include :::::: attribute :name, Types::String attribute :description, Types::String end project = Project.new(name: 'some-project', description: 'some-description') project.assign_attributes(name: 'some-project-new', description: 'some-description-new') project.name # => 'some-project-new' project.description # => 'some-description-new'
Instead of including modules you can also just use the Dry::Struct::WithSetters class which inherits from Dry::Struct and includes both modules. Note that you'll need to explicitly require it:
require 'dry/struct/with_setters' module Types include ::Types.module end class Project < :::: attribute :name, Types::String end
Hint: You can also require directly via your Gemfile:
gem 'dry-struct-setters', require: 'dry/struct/with_setters'
Add this line to your application's Gemfile:
And then execute:
Or install it yourself as:
$ gem install dry-struct-setters
After checking out the repo, run
bin/setup to install dependencies. Then, run
bin/rspec to run the tests. You can also run
bin/console for an interactive prompt that will allow you to experiment.
Bug reports and pull requests are welcome on GitHub at https://github.com/tbuehlmann/dry-struct-setters.