sequent 2.1.0 → 3.0.0

data/lib/sequent/core/projector.rb

@@ -0,0 +1,96 @@
+require_relative 'helpers/self_applier'
+require_relative './persistors/active_record_persistor'
+
+module Sequent
+  module Core
+
+    module Migratable
+      module ClassMethods
+        def manages_tables(*tables)
+          @managed_tables = tables
+        end
+
+        def managed_tables
+          @managed_tables
+        end
+      end
+
+      def self.projectors
+        Sequent.configuration.event_handlers.select { |x| x.is_a? Migratable }.map(&:class)
+      end
+
+      def self.included(host_class)
+        host_class.extend(ClassMethods)
+      end
+
+      def self.none
+        []
+      end
+
+      def self.all
+        Migratable.projectors
+      end
+
+      def managed_tables
+        self.class.managed_tables
+      end
+
+    end
+
+    # Projectors listen to events and update the view state as they see fit.
+    #
+    # Example of updating view state, in this case the InvoiceRecord table representing an Invoice
+    #
+    #   class InvoiceProjector < Sequent::Core::Projector
+    #     on InvoiceCreated do |event|
+    #       create_record(
+    #         InvoiceRecord,
+    #         recipient: event.recipient,
+    #         amount: event.amount
+    #       )
+    #     end
+    #   end
+    #
+    # Please note that the actual storage is abstracted away in the +persistors+.
+    # Due to this abstraction you can not traverse persist or traverse child objects
+    # like you are used to do with ActiveRecord. The following example will not work:
+    #
+    #   invoice_record.line_item_records << create_record(LineItemRecord, ...)
+    #
+    # In this case you should simply do:
+    #
+    #   create_record(LineItemRecord, invoice_id: invoice_record.aggregate_id)
+    #
+    class Projector
+      extend Forwardable
+      include Helpers::SelfApplier
+      include Migratable
+
+      def initialize(persistor = Sequent::Core::Persistors::ActiveRecordPersistor.new)
+        @persistor = persistor
+      end
+
+      def self.replay_persistor
+        nil
+      end
+
+      def_delegators :@persistor,
+        :update_record,
+        :create_record,
+        :create_records,
+        :create_or_update_record,
+        :get_record!,
+        :get_record,
+        :delete_all_records,
+        :update_all_records,
+        :do_with_records,
+        :do_with_record,
+        :delete_record,
+        :find_records,
+        :last_record,
+        :execute_sql,
+        :commit
+
+    end
+  end
+end

data/lib/sequent/generator.rb

@@ -0,0 +1,2 @@
+require_relative './generator/project'
+require_relative './generator/aggregate'

data/lib/sequent/generator/aggregate.rb

@@ -0,0 +1,71 @@
+require 'fileutils'
+require 'active_support'
+require 'active_support/core_ext/string'
+
+class TargetAlreadyExists < StandardError; end
+
+module Sequent
+  module Generator
+    class Aggregate
+      attr_reader :name
+
+      def initialize(name)
+        @name = name
+      end
+
+      def execute
+        ensure_not_used!
+        copy_files
+        rename_files
+        replace_template_aggregate
+      end
+
+      private
+
+      def copy_files
+        FileUtils.copy_entry(File.expand_path('template_aggregate', __dir__), path)
+      end
+
+      def rename_files
+        FileUtils.mv("#{path}/template_aggregate.rb", "#{path}/#{name_underscored}.rb")
+        FileUtils.mv("#{path}/template_aggregate", "#{path}/#{name_underscored}")
+
+        FileUtils.mv("#{path}/#{name_underscored}/template_aggregate_command_handler.rb", "#{path}/#{name_underscored}/#{name_underscored}_command_handler.rb")
+        FileUtils.mv("#{path}/#{name_underscored}/template_aggregate.rb", "#{path}/#{name_underscored}/#{name_underscored}.rb")
+      end
+
+      def replace_template_aggregate
+        files = Dir["#{path}/**/*"].select { |f| File.file?(f) }
+
+        files.each do |filename|
+          contents = File.read(filename)
+          contents.gsub!('template_aggregate', name_underscored)
+          contents.gsub!('TemplateAggregate', name_camelized)
+          File.open(filename, 'w') { |f| f.puts contents }
+        end
+      end
+
+      def path
+        @path ||= File.expand_path("lib")
+      end
+
+      def name
+        @name ||= File.basename(path)
+      end
+
+      def name_underscored
+        @name_underscored ||= name.underscore
+      end
+
+      def name_camelized
+        @name_camelized ||= name.camelize
+      end
+
+      def ensure_not_used!
+        if File.directory?("#{path}/#{name_underscored}") || File.exist?("#{path}/#{name_underscored}.rb")
+          raise TargetAlreadyExists
+        end
+      end
+    end
+  end
+end

data/lib/sequent/generator/project.rb

@@ -0,0 +1,61 @@
+require 'fileutils'
+require 'active_support'
+require 'active_support/core_ext/string'
+
+module Sequent
+  module Generator
+    class Project
+      def initialize(path_or_name)
+        @path_or_name = path_or_name
+      end
+
+      def execute
+        make_directory
+        copy_files
+        rename_app_file
+        replace_app_name
+      end
+
+      private
+
+      def make_directory
+        FileUtils.mkdir_p(path)
+      end
+
+      def copy_files
+        FileUtils.copy_entry(File.expand_path('template_project', __dir__), path)
+      end
+
+      def rename_app_file
+        FileUtils.mv("#{path}/my_app.rb", "#{path}/#{name_underscored}.rb")
+      end
+
+      def replace_app_name
+        files = Dir["#{path}/**/*"].select { |f| File.file?(f) }
+
+        files.each do |filename|
+          contents = File.read(filename)
+          contents.gsub!('my_app', name_underscored)
+          contents.gsub!('MyApp', name_camelized)
+          File.open(filename, 'w') { |f| f.puts contents }
+        end
+      end
+
+      def path
+        @path ||= File.expand_path(@path_or_name)
+      end
+
+      def name
+        @name ||= File.basename(path)
+      end
+
+      def name_underscored
+        @name_underscored ||= name.underscore
+      end
+
+      def name_camelized
+        @name_camelized ||= name.camelize
+      end
+    end
+  end
+end

data/lib/sequent/generator/template_aggregate/template_aggregate.rb

@@ -0,0 +1,4 @@
+require_relative 'template_aggregate/commands'
+require_relative 'template_aggregate/events'
+require_relative 'template_aggregate/template_aggregate'
+require_relative 'template_aggregate/template_aggregate_command_handler'

data/lib/sequent/generator/template_aggregate/template_aggregate/commands.rb

@@ -0,0 +1,2 @@
+class AddTemplateAggregate < Sequent::Command
+end

data/lib/sequent/generator/template_aggregate/template_aggregate/events.rb

@@ -0,0 +1,2 @@
+class TemplateAggregateAdded < Sequent::Event
+end

data/lib/sequent/generator/template_aggregate/template_aggregate/template_aggregate.rb

@@ -0,0 +1,9 @@
+class TemplateAggregate < Sequent::AggregateRoot
+  def initialize(command)
+    super(command.aggregate_id)
+    apply TemplateAggregateAdded
+  end
+
+  on TemplateAggregateAdded do
+  end
+end

data/lib/sequent/generator/template_aggregate/template_aggregate/template_aggregate_command_handler.rb

@@ -0,0 +1,5 @@
+class TemplateAggregateCommandHandler < Sequent::CommandHandler
+  on AddTemplateAggregate do |command|
+    repository.add_aggregate TemplateAggregate.new(command)
+  end
+end

data/lib/sequent/generator/template_project/Gemfile

@@ -0,0 +1,11 @@
+source "https://rubygems.org"
+ruby "2.5.1"
+
+gem 'rake'
+# let's use the latest and greatest
+gem 'sequent', git: 'https://github.com/zilverline/sequent', branch: 'sequent-30'
+
+group :test do
+  gem 'rspec'
+  gem 'database_cleaner'
+end

data/lib/sequent/generator/template_project/Gemfile.lock

@@ -0,0 +1,72 @@
+GIT
+  remote: https://github.com/zilverline/sequent
+  revision: 1e1066279c49d58adbb24f1a1d0e0a7e7bd10a55
+  branch: sequent-30
+  specs:
+    sequent (2.0.0)
+      activemodel (>= 5.0, < 5.2)
+      activerecord (>= 5.0, < 5.2)
+      oj (~> 3.3.9)
+      parallel (~> 1.12.1)
+      pg (~> 1.0)
+      postgresql_cursor (~> 0.6)
+      thread_safe (~> 0.3.5)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (5.1.6)
+      activesupport (= 5.1.6)
+    activerecord (5.1.6)
+      activemodel (= 5.1.6)
+      activesupport (= 5.1.6)
+      arel (~> 8.0)
+    activesupport (5.1.6)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    arel (8.0.0)
+    concurrent-ruby (1.0.5)
+    database_cleaner (1.7.0)
+    diff-lcs (1.3)
+    i18n (1.0.1)
+      concurrent-ruby (~> 1.0)
+    minitest (5.11.3)
+    oj (3.3.10)
+    parallel (1.12.1)
+    pg (1.0.0)
+    postgresql_cursor (0.6.1)
+      activerecord (>= 3.1.0)
+    rake (12.3.1)
+    rspec (3.7.0)
+      rspec-core (~> 3.7.0)
+      rspec-expectations (~> 3.7.0)
+      rspec-mocks (~> 3.7.0)
+    rspec-core (3.7.1)
+      rspec-support (~> 3.7.0)
+    rspec-expectations (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-mocks (3.7.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.7.0)
+    rspec-support (3.7.1)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  database_cleaner
+  rake
+  rspec
+  sequent!
+
+RUBY VERSION
+   ruby 2.5.1p57
+
+BUNDLED WITH
+   1.16.2

data/lib/sequent/generator/template_project/Rakefile

@@ -0,0 +1,12 @@
+ENV['RACK_ENV'] ||= 'development'
+
+require './my_app'
+require 'sequent/rake/migration_tasks'
+
+Sequent::Rake::MigrationTasks.new.register_tasks!
+
+task "sequent:migrate:init" => [:db_connect]
+
+task "db_connect" do
+  Sequent::Support::Database.connect!(ENV['RACK_ENV'])
+end

data/lib/sequent/generator/template_project/app/projectors/post_projector.rb

@@ -0,0 +1,22 @@
+require_relative '../records/post_record'
+require_relative '../../lib/post/events'
+
+class PostProjector < Sequent::Projector
+  manages_tables PostRecord
+
+  on PostAdded do |event|
+    create_record(PostRecord, aggregate_id: event.aggregate_id)
+  end
+
+  on PostAuthorChanged do |event|
+    update_all_records(PostRecord, {aggregate_id: event.aggregate_id}, event.attributes.slice(:author))
+  end
+
+  on PostTitleChanged do |event|
+    update_all_records(PostRecord, {aggregate_id: event.aggregate_id}, event.attributes.slice(:title))
+  end
+
+  on PostContentChanged do |event|
+    update_all_records(PostRecord, {aggregate_id: event.aggregate_id}, event.attributes.slice(:content))
+  end
+end

data/lib/sequent/generator/template_project/app/records/post_record.rb

@@ -0,0 +1,2 @@
+class PostRecord < ActiveRecord::Base
+end

data/lib/sequent/generator/template_project/config/initializers/sequent.rb

@@ -0,0 +1,13 @@
+require './db/migrations'
+
+Sequent.configure do |config|
+  config.migrations_class_name = 'Migrations'
+
+  config.command_handlers = [
+    PostCommandHandler.new
+  ]
+
+  config.event_handlers = [
+    PostProjector.new
+  ]
+end

data/lib/sequent/generator/template_project/db/database.yml

@@ -0,0 +1,17 @@
+database: &database
+  adapter: postgresql
+  host: localhost
+  port: 5432
+  timeout: 5000
+  schema_search_path: "sequent_schema, view_schema"
+
+development:
+  <<: *database
+  pool: 5
+  database: my_app_development
+
+test:
+  <<: *database
+  pool: 5
+  database: my_app_test
+

data/lib/sequent/generator/template_project/db/migrations.rb

@@ -0,0 +1,17 @@
+require 'sequent/migrations/projectors'
+
+VIEW_SCHEMA_VERSION = 1
+
+class Migrations < Sequent::Migrations::Projectors
+  def self.version
+    VIEW_SCHEMA_VERSION
+  end
+
+  def self.versions
+    {
+      '1' => [
+        PostProjector
+      ]
+    }
+  end
+end