Hey all, just wanted to write this post to let you know about a small ruby gem I've created, Rydux. This gem allows you to decouple the state from your logic in your application, and implements a more functional paradigm to ruby programming. You can check it out here.
To use the gem, require it somewhere in the root of your application (or somewhere the store will be accessible everywhere you need it). Next, create some reducers in your application, you can place them anywhere, but a reducers/
directory is recommended. A sample reducer looks something like this:
# reducers/user_reducer.rb
class UserReducer < Rydux::Reducer
# Your reducer MUST have a map_state function in order to do anything.
def self.map_state(action, state = {})
case action[:type]
when 'SOME_RANDOM_ACTION' # You can add as many actions here as you'd like
state.merge(some_random_data: true)
when 'APPEND_PAYLOAD'
state.merge(action[:payload])
else
state
end
end
end
Create a store somewhere easily accessible in your application:
require 'reducers/user_reducer'
# The key passed into .new here is the key at which this value
# will be stored in the state. E.g. { user: whatever_user_state }
Store = Rydux::Store.new(user: UserReducer)
Have something subscribe to the store:
class MyClass
def initialize
Store.subscribe(self)
end
# Every instance that subscribes to the store will
# get this state_changed method called whenever the state
# in the store changes. Do whatever you want with your state here.
def state_changed(state)
# ...
end
end
To update the store with new data, you can dispatch
actions, like so:
Store.dispatch(type: 'SOME_RANDOM_ACTION')
Putting it all together:
require 'rydux'
class UserReducer < Rydux::Reducer
@@initial_state = { name: 'Alex', age: 20 }
def self.map_state(action, state = @@initial_state)
case action[:type]
when 'CHANGE_USER_NAME'
state.merge(name: action[:payload][:name])
else
state
end
end
end
Store = Rydux::Store.new(user: UserReducer)
class Friend
def initialize
Store.subscribe(self)
@users_name = Store.state.user.name
end
def state_changed(state)
@users_name = state.user.name
end
def greet_user
puts "Hello, #{@users_name}"
end
end
# Create a new friend (this will subscribe it to the store)
friend = Friend.new
friend.greet_user #=> Hello, Alex
# Change a value in the store
Store.dispatch(type: 'CHANGE_USER_NAME', payload: { name: 'Mike' })
friend.greet_user #=> Hello, Mike
Top comments (1)
Wow, interesting.