Stance - Simple & Explicit Events for Rails apps

# Your model
class Appointment < ActiveRecord::Base
  include Stance::Eventable
end

# Define your events
class AppointmentEvents < Stance::Events
  # Define events.
  event :my_event
  event :some_event

  # Namespaced events
  event 'offers.create'
  event 'offers.delete'

  # Singleton event: only one active event with this name can exist for the same subject.
  event :my_event, singleton: true

  # By default, events are recorded in the database, unless you set the `record` option to false,
  event :my_recordless_event, record: false

  # You can define a class event, which is published on the class instead of the instance.
  event :my_class_event, class: true

  # Will be called before/after each event in this class. Have access to the event `subject` and
  # `record`.
  before_create :do_something_before
  after_create :do_something_after

  # Optionally, create a class for an event.
  class SomeEvent < Stance::Event
    # Define optional callbacks which have access to the `subject` and event `record`.
    before_create :do_something_before
    after_create :do_something_after
  end
end

# Publish events from the model
Appointment.find(1).publish_event :some_event
Appointment.find(1).publish_event 'offers.create'
Appointment.find(1).publish_event :event_with_metadata, foo: :bah
Appointment.publish_event :my_class_event

class Appointment < ActiveRecord::Base
  include Stance::Eventable
  include Stance::ActiveRecordCallbacks
end

class AppointmentEvents < Stance::Events
  include Stance::ActiveRecordEvents
end

# Now all your model callbacks will trigger an event of the same name, where any public methods
# defined will be called.
class AppointmentEvents::AfterCreate < Stance::Event
  include Stance::ActiveRecordEvents

  # This method will be called upon the :after_create callback of the Appointment model.
  def do_something;end

  private

    # Private methods will not be called by the callback.
    def my_private_method;end
end

gem 'stance'