event_sourcery_generators 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0bd36fd327e879aab367ddb7735f380114ab5e62
+  data.tar.gz: ec0daa66a01178d180b03f24763c9c769542991a
+SHA512:
+  metadata.gz: af41b94266b367488bc505d558bfff155a0c02b551c85737f5da1515c6eeb0bd6ac629cdb4dfb5b0ce48d1bd9cd6e9ef5369b46a39c8d1da05da2a7170041602
+  data.tar.gz: '094c8926a14ffe7beca942bf1816b7352ad491fbcd14f5259862c71bc2390258c06ed18ccb88ff60fdd36185518a27df26a21ae39e18dd70079093aaaa389f60'

data/.gitignore

@@ -0,0 +1,3 @@
+pkg/
+/.ruby-version
+/Gemfile.lock

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--format documentation
+--color

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at odindutton@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Envato
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,35 @@
+# EventSourcery Generators
+
+An opinionated CLI tool for building event sourced systems with EventSourcery.
+
+## Getting started
+
+Generate a new event sourcery application:
+
+```sh
+$ eventsourcery new recipe_book
+```
+
+Generate a new aggregate, command and event:
+
+```sh
+$ eventsourcery generate:command recipe add
+```
+
+Generate a query and projection that subscribes to events:
+
+```sh
+$ eventsourcery generate:query active_recipes recipe_added
+```
+
+Generate a reactor that subscribes to events:
+
+```sh
+$ eventsourcery generate:reactor recipe_publisher recipe_added recipe_deleted
+```
+
+## References
+
+For more information, check out the `event_sourcery` repository here:
+<https://github.com/envato/event_sourcery>
+

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/eventsourcery

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'event_sourcery_generators'
+EventSourceryGenerators::CLI.start

data/event_sourcery_generators.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'event_sourcery_generators/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'event_sourcery_generators'
+  spec.version = EventSourceryGenerators::VERSION
+  spec.authors = ['Sebastian von Conrad', 'Pablo Lee', 'Chun-wei Kuo', 'Giancarlo Salamanca']
+  spec.email = ['sebastian.von.conrad@envato.com', 'pablo.lee@envato.com', 'chun-wei.kuo@envato.com', 'giancarlo.salamanca@envato.com']
+
+  spec.summary       = 'Generators for EventSourcery'
+  spec.description   = 'An opinionated CLI tool for building event-sourced Ruby services with EventSourcery'
+  spec.homepage      = 'https://github.com/envato/event_sourcery_generators'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'bin'
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'thor', '~> 0.19'
+  spec.add_dependency 'activesupport', '~> 5.1'
+  spec.add_dependency 'verbs', '~> 2.1'
+  spec.add_development_dependency 'bundler', '~> 1.12'
+  spec.add_development_dependency 'rake', '~> 11.2'
+  spec.add_development_dependency 'rspec', '~> 3.6'
+end

data/lib/event_sourcery_generators.rb

@@ -0,0 +1,5 @@
+require 'event_sourcery_generators/cli'
+require 'event_sourcery_generators/version'
+
+module EventSourceryGenerators
+end

data/lib/event_sourcery_generators/cli.rb

@@ -0,0 +1,20 @@
+require 'thor'
+require 'active_support/inflector'
+require 'verbs'
+
+require 'event_sourcery_generators/generators/project'
+require 'event_sourcery_generators/generators/command'
+require 'event_sourcery_generators/generators/query'
+require 'event_sourcery_generators/generators/reactor'
+
+module EventSourceryGenerators
+  class CLI < Thor
+    # Creating projects
+    register(Generators::Project, 'new', 'new [PROJECT NAME]', 'Creates a new EventSourcery project')
+
+    # Creating components inside a project
+    register(Generators::Command, 'generate:command', 'generate:command [AGGREGATE] [COMMAND]', 'Generates a new COMMAND for AGGREGATE')
+    register(Generators::Query, 'generate:query', 'generate:query [NAME] [EVENT1 EVENT2 ...]', 'Generates a new query with the name NAME and an optional list of EVENTs to subscribe to')
+    register(Generators::Reactor, 'generate:reactor', 'generate:reactor NAME [EVENT1 EVENT2 ...]', 'Generates a new Reactor with the name NAME and an optional list of EVENTs to subscribe to')
+  end
+end

data/lib/event_sourcery_generators/generators/command.rb

@@ -0,0 +1,86 @@
+module EventSourceryGenerators
+  module Generators
+    class Command < Thor::Group
+      include Thor::Actions
+
+      argument :aggregate
+      argument :command
+
+      def self.source_root
+        File.join(File.dirname(__FILE__), 'templates/command')
+      end
+
+      def create_or_inject_into_aggregate_file
+        aggregate_file = "app/aggregates/#{aggregate_name}.rb"
+
+        @command_method     = erb_file('aggregate/command_method.rb.tt')
+        @apply_event_method = erb_file('aggregate/apply_event_method.rb.tt')
+
+        if File.exist?(aggregate_file)
+          insert_into_file(aggregate_file, @command_method, after: "include EventSourcery::AggregateRoot\n")
+          insert_into_file(aggregate_file, @apply_event_method, after: "include EventSourcery::AggregateRoot\n")
+        else
+          template('aggregate.rb.tt', aggregate_file)
+        end
+      end
+
+      def create_command_file
+        template('command.rb.tt', "app/commands/#{aggregate}/#{command}.rb")
+      end
+
+      def create_event
+        event_file = "app/events/#{event_name}.rb"
+
+        unless File.exist?(event_file)
+          template('event.rb.tt', event_file)
+        end
+      end
+
+      def inject_command_to_api
+        insert_into_file('app/web/server.rb', after: "< Sinatra::Base\n") do
+          erb_file('api_endpoint.rb.tt')
+        end
+      end
+
+      private
+
+      def aggregate_name
+        @aggregate_name ||= aggregate.underscore
+      end
+
+      def aggregate_class_name
+        @aggregate_class_name ||= aggregate_name.camelize
+      end
+
+      def command_name
+        @command_name ||= command.underscore
+      end
+
+      def command_class_name
+        @command_class_name ||= command_name.camelize
+      end
+
+      def event_name
+        past_participle = Verbs::Conjugator.send(:past_participle, command.downcase.to_sym).to_s
+        [ aggregate, past_participle ].map(&:underscore).join('_')
+      end
+
+      def event_class_name
+        @event_class_name ||= event_name.underscore.camelize
+      end
+
+      def erb_file(file)
+        path = File.join(self.class.source_root, file)
+        ERB.new(::File.binread(path), nil, "-", "@output_buffer").result(binding)
+      end
+
+      def project_name
+        @project_name ||= File.split(Dir.pwd).last
+      end
+
+      def project_class_name
+        @project_class_name ||= project_name.underscore.camelize
+      end
+    end
+  end
+end

data/lib/event_sourcery_generators/generators/project.rb

@@ -0,0 +1,70 @@
+module EventSourceryGenerators
+  module Generators
+    class Project < Thor::Group
+      include Thor::Actions
+
+      argument :project_name
+
+      class_options skip_tests: false, skip_setup: false
+
+      def self.source_root
+        File.join(File.dirname(__FILE__), 'templates', 'project')
+      end
+
+      def setup_ruby_project
+        template('gemfile.tt', "#{project_name}/Gemfile")
+        template('rakefile.tt', "#{project_name}/Rakefile")
+      end
+
+      def add_readme
+        template('readme.md.tt', "#{project_name}/README.md")
+      end
+
+      def setup_app
+        template('server.rb.tt', "#{project_name}/app/web/server.rb")
+
+        %w{aggregates commands events projections reactors}.each do |directory|
+          create_file("#{project_name}/app/#{directory}/.gitkeep")
+        end
+      end
+
+      def setup_environment
+        template('environment.rb.tt', "#{project_name}/config/environment.rb")
+      end
+
+      def setup_scripts
+        %w{server setup}.each do |script_name|
+          template("script_#{script_name}.tt", "#{project_name}/script/#{script_name}")
+          chmod("#{project_name}/script/#{script_name}", 0755)
+        end
+      end
+
+      def setup_rspec
+        return if options[:skip_tests]
+
+        template('spec_helper.rb.tt', "#{project_name}/spec/spec_helper.rb")
+        template('request_helpers.rb.tt', "#{project_name}/spec/support/request_helpers.rb")
+      end
+
+      def setup_processes_infrastructure
+        template('Procfile.tt', "#{project_name}/Procfile")
+        template('config.ru.tt', "#{project_name}/config.ru")
+        template('app.json.tt', "#{project_name}/app.json")
+      end
+
+      def run_setup_script
+        return if options[:skip_setup]
+
+        inside(project_name) do
+          run('./script/setup')
+        end
+      end
+
+      private
+
+      def project_class_name
+        @project_class_name ||= project_name.underscore.camelize
+      end
+    end
+  end
+end

data/lib/event_sourcery_generators/generators/query.rb

@@ -0,0 +1,51 @@
+module EventSourceryGenerators
+  module Generators
+    class Query < Thor::Group
+      include Thor::Actions
+
+      argument :query_name
+      argument :event_names, type: :array, default: []
+
+      def self.source_root
+        File.join(File.dirname(__FILE__), 'templates/query')
+      end
+
+      def create_query
+        template('query.rb.tt', "app/projections/#{query_name}/query.rb")
+      end
+
+      def create_projector
+        template('projector.rb.tt', "app/projections/#{query_name}/projector.rb")
+      end
+
+      def inject_query_to_api
+        insert_into_file('app/web/server.rb', after: "< Sinatra::Base\n") do
+          erb_file('api_endpoint.rb.tt')
+        end
+      end
+
+      def add_projector_to_rakefile
+        insert_into_file('Rakefile', erb_file('projector_process.tt'), after: "processors = [\n")
+      end
+
+      private
+
+      def project_name
+        @project_name ||= File.split(Dir.pwd).last
+      end
+
+      def project_class_name
+        @project_class_name ||= project_name.underscore.camelize
+      end
+
+      def query_class_name
+        @query_class_name ||= query_name.underscore.camelize
+      end
+
+      def erb_file(file)
+        path = File.join(self.class.source_root, file)
+        ERB.new(::File.binread(path), nil, "-", "@output_buffer").result(binding)
+      end
+    end
+  end
+end

data/lib/event_sourcery_generators/generators/reactor.rb

@@ -0,0 +1,41 @@
+module EventSourceryGenerators
+  module Generators
+    class Reactor < Thor::Group
+      include Thor::Actions
+
+      argument :reactor_name
+      argument :event_names, type: :array, default: []
+
+      def self.source_root
+        File.join(File.dirname(__FILE__), 'templates/reactor')
+      end
+
+      def create_reactor
+        template('reactor.rb.tt', "app/reactors/#{reactor_name}.rb")
+      end
+
+      def add_reactor_to_rakefile
+        insert_into_file('Rakefile', erb_file('reactor_process.tt'), after: "processors = [\n")
+      end
+
+      private
+
+      def project_name
+        @project_name ||= File.split(Dir.pwd).last
+      end
+
+      def project_class_name
+        @project_class_name ||= project_name.underscore.camelize
+      end
+
+      def reactor_class_name
+        @reactor_class_name ||= reactor_name.underscore.camelize
+      end
+
+      def erb_file(file)
+        path = File.join(self.class.source_root, file)
+        ERB.new(::File.binread(path), nil, "-", "@output_buffer").result(binding)
+      end
+    end
+  end
+end

data/lib/event_sourcery_generators/generators/templates/command/aggregate.rb.tt

@@ -0,0 +1,8 @@
+module <%= project_class_name %>
+  module Aggregates
+    class <%= aggregate_class_name %>
+      include EventSourcery::AggregateRoot
+<%= @apply_event_method %><%= @command_method -%>
+    end
+  end
+end

data/lib/event_sourcery_generators/generators/templates/command/aggregate/apply_event_method.rb.tt

@@ -0,0 +1,6 @@
+
+      apply <%= event_class_name %> do |event|
+        # Mutate state of aggregate based on event, e.g.
+        # @<%= event_name %>_occurred = true
+      end
+

data/lib/event_sourcery_generators/generators/templates/command/aggregate/command_method.rb.tt

@@ -0,0 +1,11 @@
+      def <%= command_name %>(payload)
+        # Perform any relevant contextual validations on aggregate
+
+        # Apply the event without persistence
+        apply_event(
+          <%= event_class_name %>,
+          aggregate_id: id,
+          body:         payload,
+        )
+      end
+

data/lib/event_sourcery_generators/generators/templates/command/api_endpoint.rb.tt

@@ -0,0 +1,6 @@
+    post '/<%= aggregate.pluralize %>/:aggregate_id/<%= command %>' do
+      command = Commands::<%= aggregate_class_name %>::<%= command_class_name %>::Command.new(json_params)
+      Commands::<%= aggregate_class_name %>::<%= command_class_name %>::CommandHandler.new.handle(command)
+      status 201
+    end
+

data/lib/event_sourcery_generators/generators/templates/command/command.rb.tt

@@ -0,0 +1,40 @@
+require 'app/aggregates/<%= aggregate_name %>'
+
+module <%= project_class_name %>
+  module Commands
+    module <%= aggregate_class_name %>
+      module <%= command_class_name %>
+        class Command
+          attr_reader :aggregate_id, :payload
+
+          def initialize(params)
+            @aggregate_id = params.delete(:aggregate_id)
+            @payload = params # Select the parameters you want to allow
+          end
+
+          def validate
+            # Add validation here
+          end
+        end
+
+        class CommandHandler
+          def initialize(repository: <%= project_class_name %>.repository)
+            @repository = repository
+          end
+
+          def handle(command)
+            command.validate
+
+            aggregate = repository.load(Aggregates::<%= aggregate_class_name %>, command.aggregate_id)
+            aggregate.<%= command_name %>(command.payload)
+            repository.save(aggregate)
+          end
+
+          private
+
+          attr_reader :repository
+        end
+      end
+    end
+  end
+end

data/lib/event_sourcery_generators/generators/templates/command/event.rb.tt

@@ -0,0 +1 @@
+<%= event_class_name %> = Class.new(EventSourcery::Event)

data/lib/event_sourcery_generators/generators/templates/project/app.json.tt

@@ -0,0 +1,16 @@
+{
+  "name": "<%= project_class_name %>",
+  "description": "<%= project_class_name %>, an EventSourcery app",
+  "keywords": ["<%= project_name %>", "ruby", "event_sourcery", "cqrs"],
+  "formation": {
+    "web": {
+      "quantity": 1
+    },
+    "processors": {
+      "quantity": 1
+    }
+  },
+  "scripts": {
+    "postdeploy": "bundle exec rake db:migrate"
+  }
+}

data/lib/event_sourcery_generators/generators/templates/project/config.ru.tt

@@ -0,0 +1,6 @@
+$LOAD_PATH << '.'
+
+require 'config/environment'
+require 'app/web/server'
+
+run <%= project_class_name %>::Server.new

data/lib/event_sourcery_generators/generators/templates/project/environment.rb.tt

@@ -0,0 +1,64 @@
+require 'event_sourcery'
+require 'event_sourcery/postgres'
+
+Dir.glob(__dir__ + '/../app/events/*.rb').each { |f| require f }
+Dir.glob(__dir__ + '/../app/reactors/*.rb').each { |f| require f }
+Dir.glob(__dir__ + '/../app/projections/**/projector.rb').each { |f| require f }
+
+module <%= project_class_name %>
+  class Config
+    attr_accessor :database_url
+  end
+
+  def self.config
+    @config ||= Config.new
+  end
+
+  def self.configure
+    yield config
+  end
+
+  def self.environment
+    ENV.fetch('RACK_ENV', 'development')
+  end
+
+  def self.event_store
+    EventSourcery::Postgres.config.event_store
+  end
+
+  def self.event_source
+    EventSourcery::Postgres.config.event_store
+  end
+
+  def self.tracker
+    EventSourcery::Postgres.config.event_tracker
+  end
+
+  def self.event_sink
+    EventSourcery::Postgres.config.event_sink
+  end
+
+  def self.projections_database
+    EventSourcery::Postgres.config.projections_database
+  end
+
+  def self.repository
+    @repository ||= EventSourcery::Repository.new(
+      event_source: event_source,
+      event_sink: event_sink
+    )
+  end
+end
+
+<%= project_class_name %>.configure do |config|
+  config.database_url = ENV['DATABASE_URL'] || "postgres://127.0.0.1:5432/<%= project_name.underscore %>_#{<%= project_class_name %>.environment}"
+end
+
+EventSourcery::Postgres.configure do |config|
+  database = Sequel.connect(<%= project_class_name %>.config.database_url)
+
+  # NOTE: Often we choose to split our events and projections into separate
+  # databases. For the purposes of this example we'll use one.
+  config.event_store_database = database
+  config.projections_database = database
+end

data/lib/event_sourcery_generators/generators/templates/project/gemfile.tt

@@ -0,0 +1,19 @@
+source 'https://rubygems.org'
+
+gem 'event_sourcery', git: 'https://github.com/envato/event_sourcery.git'
+gem 'event_sourcery-postgres', git: 'https://github.com/envato/event_sourcery-postgres.git'
+
+gem 'rake'
+gem 'sinatra'
+# NOTE: pg is an implicit dependency of event_sourcery-postgres but we need to
+# lock to an older version for deprecation warnings.
+gem 'pg', '0.20.0'
+
+group :development, :test do
+  gem 'pry'
+  gem 'rspec'
+  gem 'rack-test'
+  gem 'database_cleaner'
+  gem 'better_errors'
+  gem 'shotgun'
+end

data/lib/event_sourcery_generators/generators/templates/project/procfile.tt

@@ -0,0 +1,2 @@
+web: ./script/server
+processors: bundle exec rake run_processors

data/lib/event_sourcery_generators/generators/templates/project/rakefile.tt

@@ -0,0 +1,69 @@
+$LOAD_PATH.unshift '.'
+
+task :environment do
+  require 'config/environment'
+end
+
+desc 'Run Event Stream Processors'
+task run_processors: :environment do
+  puts 'Starting Event Stream processors'
+
+  event_source = <%= project_class_name %>.event_source
+  tracker = <%= project_class_name %>.tracker
+  db_connection = <%= project_class_name %>.projections_database
+
+  # Need to disconnect before starting the processors
+  # to ensure each forked process has its own connection
+  db_connection.disconnect
+
+  # Show our ESP logs in foreman immediately
+  $stdout.sync = true
+
+  processors = [
+    # Add your processors here, like so:
+    #
+    # EventSourceryTodoApp::Projections::CompletedTodos::Projector.new(
+    #   tracker: tracker,
+    #   db_connection: db_connection,
+    # ),
+  ]
+
+  EventSourcery::EventProcessing::ESPRunner.new(
+    event_processors: processors,
+    event_source: event_source,
+  ).start!
+end
+
+namespace :db do
+  desc 'Create database'
+  task create: :environment do
+    url = <%= project_class_name %>.config.database_url
+    database_name = File.basename(url)
+    database = Sequel.connect URI.join(url, '/template1').to_s
+    begin
+      database.run("CREATE DATABASE #{database_name}")
+    rescue StandardError => e
+      puts "Could not create database '#{database_name}': #{e.class.name} #{e.message}"
+    end
+    database.disconnect
+  end
+
+  desc 'Drop database'
+  task drop: :environment do
+    url = <%= project_class_name %>.config.database_url
+    database_name = File.basename(url)
+    database = Sequel.connect URI.join(url, '/template1').to_s
+    database.run("DROP DATABASE IF EXISTS #{database_name}")
+    database.disconnect
+  end
+
+  desc 'Migrate database'
+  task migrate: :environment do
+    database = EventSourcery::Postgres.config.event_store_database
+    begin
+      EventSourcery::Postgres::Schema.create_event_store(db: database)
+    rescue StandardError => e
+      puts "Could not create event store: #{e.class.name} #{e.message}"
+    end
+  end
+end

data/lib/event_sourcery_generators/generators/templates/project/readme.md.tt

@@ -0,0 +1,39 @@
+# <%= project_class_name %>
+
+[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)
+
+## Get started
+
+Ensure you have Postgres and Ruby 2.3 or higher installed, then run the setup script:
+
+```sh
+$ ./script/setup
+```
+
+## Using the Application
+
+Start the web server and processors (reactors and projectors):
+
+```sh
+$ foreman start
+```
+
+## Adding features
+
+Generate a new aggregate, command and event:
+
+```sh
+$ eventsourcery generate:command recipe add
+```
+
+Generate a query and projection that subscribes to events:
+
+```sh
+$ eventsourcery generate:query active_recipes recipe_added
+```
+
+Generate a reactor that subscribes to events:
+
+```sh
+$ eventsourcery generate:reactor recipe_publisher recipe_added recipe_deleted
+```

data/lib/event_sourcery_generators/generators/templates/project/request_helpers.rb.tt

@@ -0,0 +1,10 @@
+module RequestHelpers
+  def app
+    @@app ||= <%= project_class_name %>::Server
+  end
+
+  def last_event(aggregate_id)
+    <%= project_class_name %>.event_store
+      .get_events_for_aggregate_id(aggregate_id).last
+  end
+end

data/lib/event_sourcery_generators/generators/templates/project/script_server.tt

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+
+if [ $RACK_ENV == production ]; then
+  bundle exec rackup -p $PORT
+else
+  bundle exec shotgun -p 3000
+fi

data/lib/event_sourcery_generators/generators/templates/project/script_setup.tt

@@ -0,0 +1,22 @@
+#!/usr/bin/env bash
+
+echo
+echo "--- Installing bundled gems"
+echo
+
+bundle install
+
+if ! type -t "foreman" > /dev/null; then
+  echo
+  echo "--- Installing foreman"
+  echo
+
+  gem install foreman
+fi
+
+echo
+echo "--- Creating and migrating databases"
+echo
+
+bundle exec rake db:create db:migrate
+RACK_ENV=test bundle exec rake db:create db:migrate

data/lib/event_sourcery_generators/generators/templates/project/server.rb.tt

@@ -0,0 +1,59 @@
+require 'sinatra'
+
+Dir.glob(__dir__ + '/../commands/**/*.rb').each { |f| require f }
+Dir.glob(__dir__ + '/../projections/**/query.rb').each { |f| require f }
+
+module <%= project_class_name %>
+  class Server < Sinatra::Base
+    BadRequest = Class.new(StandardError)
+    UnprocessableEntity = Class.new(StandardError)
+
+    # Ensure our error handlers are triggered in development
+    set :show_exceptions, :after_handler
+
+    configure :development do
+      require 'better_errors'
+      use BetterErrors::Middleware
+      BetterErrors.application_root = __dir__
+    end
+
+    error UnprocessableEntity do |error|
+      body "Unprocessable Entity: #{error.message}"
+      status 422
+    end
+
+    error BadRequest do |error|
+      body "Bad Request: #{error.message}"
+      status 400
+    end
+
+    before do
+      content_type :json
+    end
+
+    def json_params
+      # Coerce this into a symbolised Hash so Sinatra data
+      # structures don't leak into the command layer
+
+      request_body = request.body.read
+      unless request_body.empty?
+        params.merge!(JSON.parse(request_body))
+      end
+
+      Hash[
+        params.map{ |k, v| [k.to_sym, v] }
+      ]
+    end
+
+    # Add your API routes here!
+    #
+    # eg.
+    # get '/todos' do
+    #   ...
+    # end
+    #
+    # post '/todo/:id' do
+    #   ...
+    # end
+  end
+end

data/lib/event_sourcery_generators/generators/templates/project/spec_helper.rb.tt

@@ -0,0 +1,38 @@
+ENV['RACK_ENV'] = 'test'
+
+require 'rack/test'
+require 'securerandom'
+require 'database_cleaner'
+
+$LOAD_PATH << '.'
+
+require 'app/web/server'
+require 'config/environment'
+require 'spec/support/request_helpers'
+
+RSpec.configure do |config|
+  config.include(Rack::Test::Methods, type: :request)
+  config.include(RequestHelpers, type: :request)
+
+  config.expect_with :rspec do |expectations|
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  config.mock_with :rspec do |mocks|
+    mocks.verify_partial_doubles = true
+  end
+
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+  config.disable_monkey_patching!
+  config.order = :random
+  Kernel.srand config.seed
+
+  EventSourcery.configure do |config|
+    config.logger = Logger.new(nil)
+  end
+
+  config.before do
+    DatabaseCleaner.strategy = :truncation
+    DatabaseCleaner.clean
+  end
+end

data/lib/event_sourcery_generators/generators/templates/query/api_endpoint.rb.tt

@@ -0,0 +1,7 @@
+    get '/<%= query_name %>' do
+      body JSON.pretty_generate(
+        <%= project_class_name %>::Projections::<%= query_class_name %>::Query.handle
+      )
+      status 200
+    end
+

data/lib/event_sourcery_generators/generators/templates/query/projector.rb.tt

@@ -0,0 +1,40 @@
+module <%= project_class_name %>
+  module Projections
+    module <%= query_class_name %>
+      class Projector
+        include EventSourcery::Postgres::Projector
+
+        projector_name :<%= query_name %>
+
+        table :query_<%= query_name %> do
+          # Add your projection table columns here, eg:
+          # column :todo_id, 'UUID NOT NULL'
+          # column :title, :text
+          # column :due_date, DateTime
+        end
+    <%- if event_names.empty? -%>
+
+        # project TodoAdded do |event|
+        #   Modify your projection table here, eg:
+        #   table.insert(
+        #     todo_id: event.aggregate_id,
+        #     title: event.body['title'],
+        #     due_date: event.body['due_date'],
+        #   )
+        # end
+    <%- else -%>
+      <% event_names.each do |event_name| %>
+        project <%= event_name.underscore.camelize %> do |event|
+          #   Modify your projection table here, eg:
+          #   table.insert(
+          #     todo_id: event.aggregate_id,
+          #     title: event.body['title'],
+          #     due_date: event.body['due_date'],
+          #   )
+        end
+      <%- end -%>
+    <%- end -%>
+      end
+    end
+  end
+end

data/lib/event_sourcery_generators/generators/templates/query/projector_process.tt

@@ -0,0 +1,4 @@
+    <%= project_class_name %>::Projections::<%= query_class_name %>::Projector.new(
+      tracker: tracker,
+      db_connection: db_connection,
+    ),

data/lib/event_sourcery_generators/generators/templates/query/query.rb.tt

@@ -0,0 +1,11 @@
+module <%= project_class_name %>
+  module Projections
+    module <%= query_class_name %>
+      class Query
+        def self.handle
+          <%= project_class_name %>.projections_database[:query_<%= query_name %>].all
+        end
+      end
+    end
+  end
+end

data/lib/event_sourcery_generators/generators/templates/reactor/reactor.rb.tt

@@ -0,0 +1,42 @@
+module <%= project_class_name %>
+  module Reactors
+    class <%= reactor_class_name %>
+      include EventSourcery::Postgres::Reactor
+
+      processor_name :<%= reactor_name.underscore %>
+
+      # emits_events ExampleEvent, AnotherEvent
+
+      # table :reactor_<%= reactor_name.underscore %> do
+      #   column :todo_id, :uuid, primary_key: true
+      #   column :title,   :text
+      # end
+
+    <%- if event_names.empty? -%>
+      # process TodoAdded do |event|
+      #   table.insert(
+      #     todo_id: event.aggregate_id,
+      #     title:   event.body['title'],
+      #   )
+      # end
+
+      # process TodoCompleted do |event|
+      #   todo = table.where(todo_id: event.aggregate_id).first
+      #
+      #   emit_event(
+      #     StakeholderNotifiedOfTodoCompletion.new(
+      #       aggregate_id: event.aggregate_id,
+      #       body:         { title: todo[:title] },
+      #     )
+      #   )
+      # end
+    <%- else -%>
+      <% event_names.each do |event_name| %>
+      process <%= event_name.underscore.camelize %> do |event|
+        # Update scratch tables, emit events, ...
+      end
+      <%- end -%>
+    <%- end -%>
+    end
+  end
+end

data/lib/event_sourcery_generators/generators/templates/reactor/reactor_process.tt

@@ -0,0 +1,4 @@
+    <%= project_class_name %>::Reactors::<%= reactor_class_name %>.new(
+      tracker: tracker,
+      db_connection: db_connection,
+    ),

data/lib/event_sourcery_generators/version.rb

@@ -0,0 +1,3 @@
+module EventSourceryGenerators
+  VERSION = '0.2.0'
+end

metadata

@@ -0,0 +1,175 @@
+--- !ruby/object:Gem::Specification
+name: event_sourcery_generators
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Sebastian von Conrad
+- Pablo Lee
+- Chun-wei Kuo
+- Giancarlo Salamanca
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-06-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.19'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.1'
+- !ruby/object:Gem::Dependency
+  name: verbs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '11.2'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.6'
+description: An opinionated CLI tool for building event-sourced Ruby services with
+  EventSourcery
+email:
+- sebastian.von.conrad@envato.com
+- pablo.lee@envato.com
+- chun-wei.kuo@envato.com
+- giancarlo.salamanca@envato.com
+executables:
+- eventsourcery
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/eventsourcery
+- event_sourcery_generators.gemspec
+- lib/event_sourcery_generators.rb
+- lib/event_sourcery_generators/cli.rb
+- lib/event_sourcery_generators/generators/command.rb
+- lib/event_sourcery_generators/generators/project.rb
+- lib/event_sourcery_generators/generators/query.rb
+- lib/event_sourcery_generators/generators/reactor.rb
+- lib/event_sourcery_generators/generators/templates/command/aggregate.rb.tt
+- lib/event_sourcery_generators/generators/templates/command/aggregate/apply_event_method.rb.tt
+- lib/event_sourcery_generators/generators/templates/command/aggregate/command_method.rb.tt
+- lib/event_sourcery_generators/generators/templates/command/api_endpoint.rb.tt
+- lib/event_sourcery_generators/generators/templates/command/command.rb.tt
+- lib/event_sourcery_generators/generators/templates/command/event.rb.tt
+- lib/event_sourcery_generators/generators/templates/project/app.json.tt
+- lib/event_sourcery_generators/generators/templates/project/config.ru.tt
+- lib/event_sourcery_generators/generators/templates/project/environment.rb.tt
+- lib/event_sourcery_generators/generators/templates/project/gemfile.tt
+- lib/event_sourcery_generators/generators/templates/project/procfile.tt
+- lib/event_sourcery_generators/generators/templates/project/rakefile.tt
+- lib/event_sourcery_generators/generators/templates/project/readme.md.tt
+- lib/event_sourcery_generators/generators/templates/project/request_helpers.rb.tt
+- lib/event_sourcery_generators/generators/templates/project/script_server.tt
+- lib/event_sourcery_generators/generators/templates/project/script_setup.tt
+- lib/event_sourcery_generators/generators/templates/project/server.rb.tt
+- lib/event_sourcery_generators/generators/templates/project/spec_helper.rb.tt
+- lib/event_sourcery_generators/generators/templates/query/api_endpoint.rb.tt
+- lib/event_sourcery_generators/generators/templates/query/projector.rb.tt
+- lib/event_sourcery_generators/generators/templates/query/projector_process.tt
+- lib/event_sourcery_generators/generators/templates/query/query.rb.tt
+- lib/event_sourcery_generators/generators/templates/reactor/reactor.rb.tt
+- lib/event_sourcery_generators/generators/templates/reactor/reactor_process.tt
+- lib/event_sourcery_generators/version.rb
+homepage: https://github.com/envato/event_sourcery_generators
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.11
+signing_key: 
+specification_version: 4
+summary: Generators for EventSourcery
+test_files: []