disco-railties 0.5.0.rc1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 62f23a6b10dcf4e0713820c095a72ad018b0bc8b
+  data.tar.gz: 9f180b0beec4b72601f52654452f4bcb00fd8915
+SHA512:
+  metadata.gz: fea79118ee04f8ec04c221d8fde4e40eeab7c2ba3a9b720ac0b09f4773c9a62d0f1b6d025ba081b8bc31aa31eb7101155ea8f58a2118e497cb9e37ddb3b631f2
+  data.tar.gz: 775eae3ebb53b9502f7e07df793c3b7e73db01c896ae3151bc878ae2c36c4161049c8d9213cf2205580c88dac6ba5e368079c3c591f1898b2b7115b0bfdd995d

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Robert Kranz
+
+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/Rakefile

@@ -0,0 +1 @@
+Dir.glob('lib/tasks/*.rake').each {|r| import r}

data/bin/disco

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+unless Gem::Specification.find_by_name('disco-railties').gem_dir == File.expand_path('../..', __FILE__)
+  $:.push File.expand_path('../../lib', __FILE__)
+  $:.delete "#{Gem::Specification.find_by_name('disco-railties').gem_dir}/lib"
+end
+require 'disco/cli'

data/bin/drails

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+
+puts "This executable is outdated! Use 'disco' instead."

data/lib/disco/app_disco_loader.rb

@@ -0,0 +1,62 @@
+require 'pathname'
+
+module Disco
+  module AppDiscoLoader
+    RUBY = File.join(*RbConfig::CONFIG.values_at('bindir', 'ruby_install_name')) + RbConfig::CONFIG['EXEEXT']
+    EXECUTABLES = ['bin/disco']
+    BUNDLER_WARNING = <<EOS
+Looks like your app's ./bin/disco is a stub that was generated by Bundler.
+
+In Rails Disco, your app's bin/ directory contains executables that are versioned
+like any other source code, rather than stubs that are generated on demand.
+
+Here's how to upgrade:
+
+  bundle config --delete bin    # Turn off Bundler's stub generator
+  rake disco:update:bin        # Use the new Rails Disco executables
+  git add bin                   # Add bin/ to source control
+
+You may need to remove bin/ from your .gitignore as well.
+
+When you install a gem whose executable you want to use in your app,
+generate it and add it to source control:
+
+  bundle binstubs some-gem-name
+  git add bin/new-executable
+
+EOS
+
+    def self.exec_app_disco
+      original_cwd = Dir.pwd
+
+      loop do
+        exe = find_executable
+        if exe
+          contents = File.read(exe)
+
+          if contents =~ /(APP|ENGINE)_PATH/
+            exec RUBY, exe, *ARGV
+            break # non reachable, hack to be able to stub exec in the test suite
+          elsif exe.end_with?('bin/disco') && contents.include?('This file was generated by Bundler')
+            $stderr.puts(BUNDLER_WARNING)
+            Object.const_set(:APP_PATH, File.expand_path('config/application', Dir.pwd))
+            require File.expand_path('../boot', APP_PATH)
+            require 'disco/commands'
+            break
+          end
+        end
+
+        # If we exhaust the search there is no executable, this could be a
+        # call to generate a new application, so restore the original cwd.
+        Dir.chdir(original_cwd) and return if Pathname.new(Dir.pwd).root?
+
+        # Otherwise keep moving upwards in search of a executable.
+        Dir.chdir('..')
+      end
+    end
+
+    def self.find_executable
+      EXECUTABLES.find { |exe| File.exists?(exe) }
+    end
+  end
+end

data/lib/disco/cli.rb

@@ -0,0 +1,11 @@
+require 'rbconfig'
+require 'disco/app_disco_loader'
+
+# If we are inside a Rails application this method performs an exec and thus
+# the rest of this script is not run.
+Disco::AppDiscoLoader.exec_app_disco
+
+require 'rails/ruby_version_check'
+Signal.trap('INT') { puts; exit(1) }
+
+require 'disco/commands/application'

data/lib/disco/commands/application.rb

@@ -0,0 +1,43 @@
+require 'rails-disco/version'
+
+if ['--version', '-v'].include?(ARGV.first)
+  puts "Rails Disco #{RailsDisco::VERSION::STRING}"
+  exit(0)
+end
+
+if ARGV.first != "new"
+  ARGV[0] = "--help"
+else
+  ARGV.shift
+  unless ARGV.delete("--no-rc")
+    customrc = ARGV.index{ |x| x.include?("--rc=") }
+    railsrc = if customrc
+                File.expand_path(ARGV.delete_at(customrc).gsub(/--rc=/, ""))
+              else
+                File.join(File.expand_path("~"), '.railsrc')
+              end
+    if File.exist?(railsrc)
+      extra_args_string = File.read(railsrc)
+      extra_args = extra_args_string.split(/\n+/).map {|l| l.split}.flatten
+      puts "Using #{extra_args.join(" ")} from #{railsrc}"
+      ARGV.insert(1, *extra_args)
+    end
+  end
+end
+
+require 'rails/generators'
+require 'generators/disco/app/app_generator'
+
+module Disco
+  module Generators
+    class AppGenerator # :nodoc:
+      # We want to exit on failure to be kind to other libraries
+      # This is only when accessing via CLI
+      def self.exit_on_failure?
+        true
+      end
+    end
+  end
+end
+
+Disco::Generators::AppGenerator.start

data/lib/disco/commands/destroy.rb

@@ -0,0 +1,12 @@
+require 'disco/generators'
+
+if [nil, '-h', '--help'].include?(ARGV.first)
+  Rails::Generators.help 'destroy'
+  exit
+end
+
+name = ARGV.shift
+name = name.sub(/^disco:/, '')
+
+root = defined?(ENGINE_ROOT) ? ENGINE_ROOT : Rails.root
+Rails::Generators.invoke "disco:#{name}", ARGV, behavior: :revoke, destination_root: root

data/lib/disco/commands/domainserver.rb

@@ -0,0 +1,6 @@
+puts 'Starting Domain Command Server'
+puts '=> Ctrl-C to shutdown domain server'
+Signal.trap('INT') { puts; exit(1) }
+
+Process.spawn({'ROOT_DIR' => Dir.pwd}, "ruby #{File.expand_path '../../server', __FILE__}/domain_server.rb")
+Process.waitall

data/lib/disco/commands/generate.rb

@@ -0,0 +1,12 @@
+require 'disco/generators'
+
+if [nil, '-h', '--help'].include?(ARGV.first)
+  Rails::Generators.help 'generate'
+  exit
+end
+
+name = ARGV.shift
+name = name.sub(/^disco:/, '')
+
+root = defined?(ENGINE_ROOT) ? ENGINE_ROOT : Rails.root
+Rails::Generators.invoke "disco:#{name}", ARGV, behavior: :invoke, destination_root: root

data/lib/disco/commands/projectionserver.rb

@@ -0,0 +1,9 @@
+count = [ARGV.shift.to_i, 1].max
+puts "Starting Projection Server (#{count} processes)"
+puts '=> Ctrl-C to shutdown projections server'
+Signal.trap('INT') { puts; exit(1) }
+
+count.times do |i|
+  Process.spawn({'ROOT_DIR' => Dir.pwd, 'WORKER_COUNT' => count.to_s, 'WORKER_NUMBER' => i.to_s}, "ruby #{File.expand_path '../../server', __FILE__}/projection_servers.rb")
+end
+Process.waitall

data/lib/disco/commands/server.rb

@@ -0,0 +1,22 @@
+count = [ARGV.shift.to_i, 1].max
+puts "Starting domain, projection (*#{count}) and Rails server..."
+puts '=> Ctrl-C to shutdown all servers'
+env = {'ROOT_DIR' => Dir.pwd}
+pids = []
+pids << Process.spawn(env, "ruby #{File.expand_path '../../server', __FILE__}/domain_server.rb")
+count.times do |i|
+  pids << Process.spawn(env.merge('WORKER_COUNT' => count.to_s, 'WORKER_NUMBER' => i.to_s), "ruby #{File.expand_path '../../server', __FILE__}/projection_servers.rb")
+end
+pids << Process.spawn(env, 'rails s')
+trap(:INT) do
+  pids.each do |pid|
+    begin
+      Process.kill 9, pid
+    rescue Exception
+      # do nothing
+    end
+  end
+  puts
+  exit(1)
+end
+Process.waitall

data/lib/disco/commands.rb

@@ -0,0 +1,70 @@
+ARGV << '--help' if ARGV.empty?
+
+aliases = {
+    'ds' => 'domainserver',
+    's' => 'server',
+    'ps' => 'projectionserver',
+    'g' => 'generate',
+    '-h' => '--help',
+    '-v' => '--version',
+}
+
+help_message = <<-EOT
+Usage: disco COMMAND [ARGS]
+
+The most common disco commands are:
+ generate(g)           Generate new Rails Disco code
+ domainserver(ds)      Start the domain server
+ projectionserver(ps)  Start the projection server
+ server(s)             Start domain and projection server
+ new                   Creates a new Rails Disco application
+                       "disco new my_app" creates a
+                       new application called MyApp in "./my_app"
+
+In addition to those, there are:
+ application           Generate the Rails Disco application code
+ destroy(d)            Undo code generated with "generate"
+
+All commands can be run with -h (or --help) for more information.
+EOT
+
+
+command = ARGV.shift
+command = aliases[command] || command
+
+case command
+  when 'generate', 'destroy'
+    require 'disco/generators'
+
+    require APP_PATH
+    Rails.application.require_environment!
+    Rails.application.load_generators
+
+    require "disco/commands/#{command}"
+
+  when 'server', 'domainserver', 'projectionserver'
+    Dir.chdir(File.expand_path('../../', APP_PATH)) unless File.exists?(File.expand_path('config.ru'))
+
+    require "disco/commands/#{command}"
+
+  when 'new'
+    if %w(-h --help).include?(ARGV.first)
+      require 'disco/commands/application'
+    else
+      puts "Can't initialize a new Rails Disco application within the directory of another, please change to a non-Rails Disco directory first.\n"
+      puts "Type 'disco' for help."
+      exit(1)
+    end
+
+  when '--version'
+    require 'rails-disco/version'
+    puts "Rails Disco #{RailsDisco::VERSION::STRING}"
+
+  when '--help'
+    puts help_message
+
+  else
+    puts "Error: Command '#{command}' not recognized"
+    puts help_message
+    exit(1)
+end

data/lib/disco/generators.rb

@@ -0,0 +1,48 @@
+require 'rails/generators'
+
+module Rails
+  module Generators
+
+    def self.help(command = 'generate')
+      lookup!
+
+      namespaces = subclasses.map { |k| k.namespace }
+      namespaces.sort!
+
+      disco = []
+      namespaces.each do |namespace|
+        disco << namespace if namespace.split(':').first == 'disco'
+      end
+
+      puts <<-EOT
+Usage: disco #{command} GENERATOR [args] [options]
+
+General options:
+  -h, [--help]     # Print generator's options and usage
+  -p, [--pretend]  # Run but do not make any changes
+  -f, [--force]    # Overwrite files that already exist
+  -s, [--skip]     # Skip files that already exist
+  -q, [--quiet]    # Suppress status output
+
+Please choose a generator below.
+
+      EOT
+
+      disco.reject! { |n| hidden_namespaces.include?(n) }
+      disco.map! { |n| n.sub(/^disco:/, '') }
+      disco.delete('app')
+      disco.delete('plugin_new')
+      print_list('disco', disco)
+    end
+
+  end
+end
+
+Rails::Generators.options.deep_merge! disco: {
+    command: :command,
+    command_processor: :command_processor,
+    migration: :migration,
+    model: :model,
+    projection: :projection,
+    scaffold_controller: :scaffold_controller,
+}

data/lib/disco/server/domain_server.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby.exe
+ROOT_DIR ||= ENV['ROOT_DIR']
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('Gemfile', ROOT_DIR)
+require 'bundler/setup' if File.exists?(ENV['BUNDLE_GEMFILE'])
+
+require 'active_event'
+require 'active_domain'
+require 'active_record'
+
+LOGGER = ActiveEvent::Support::MultiLogger.new 'Domain Server'
+
+ActiveEvent::Autoload.app_path = ROOT_DIR
+ActiveDomain::Autoload.app_path = ROOT_DIR
+
+watchable_dirs = ActiveEvent::Autoload.watchable_dirs.merge ActiveDomain::Autoload.watchable_dirs
+RELOADER = ActiveSupport::FileUpdateChecker.new([], watchable_dirs) do
+  ActiveEvent::Autoload.reload_module :ValidationsRegistry
+  ActiveDomain::Autoload.reload_module :ProjectionRegistry
+  ActiveEvent::Autoload.reload
+  ActiveDomain::Autoload.reload
+  ActiveEvent::ValidationsRegistry.build
+end
+
+ActiveEvent::ValidationsRegistry.build
+ActiveDomain::Server.base_path = ROOT_DIR
+ActiveDomain::Server.run

data/lib/disco/server/projection_servers.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby.exe
+ROOT_DIR ||= ENV['ROOT_DIR']
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('Gemfile', ROOT_DIR)
+require 'bundler/setup' if File.exists?(ENV['BUNDLE_GEMFILE'])
+
+require 'active_event'
+require 'active_projection'
+require 'active_record'
+
+WORKER_COUNT = [ENV['WORKER_COUNT'].to_i, 1].max
+WORKER_NUMBER = ENV['WORKER_NUMBER'].to_i
+LOGGER = ActiveEvent::Support::MultiLogger.new "Projection Server#{WORKER_COUNT > 1 ? " Nr. #{WORKER_NUMBER}" : ""}"
+
+ActiveEvent::Autoload.app_path = ROOT_DIR
+ActiveProjection::Autoload.app_path = ROOT_DIR
+ActiveProjection::Autoload.worker_config = {path: ROOT_DIR, count: WORKER_COUNT, number: WORKER_NUMBER}
+
+watchable_dirs = ActiveEvent::Autoload.watchable_dirs.merge ActiveProjection::Autoload.watchable_dirs
+RELOADER = ActiveSupport::FileUpdateChecker.new([], watchable_dirs) do
+  ActiveEvent::Autoload.reload_module :ValidationsRegistry
+  ActiveProjection::Autoload.reload_module :ProjectionTypeRegistry
+  ActiveEvent::Autoload.reload
+  ActiveProjection::Autoload.reload
+end
+ActiveProjection::Server.base_path = ROOT_DIR
+ActiveProjection::Server.run

data/lib/generators/disco/app/USAGE

@@ -0,0 +1,14 @@
+Description:
+    Create a new Rails Disco app or add Rails Disco to your project.
+
+Example:
+    rails generate disco:app .
+
+    This will create:
+        bin/disco
+        app/controllers/event_source_controller.rb
+        a route for this controller
+        config/initializers/build_validations_registry.rb
+        config/initializers/create_domain.rb
+        config/disco.yml
+        adds rails-disco to your gemfile

data/lib/generators/disco/app/app_generator.rb

@@ -0,0 +1,140 @@
+require 'rails/generators/rails/app/app_generator'
+require 'yaml'
+
+module Disco
+  class AppBuilder < Rails::AppBuilder
+
+    def gemfile
+      super
+      append_file 'Gemfile', "\n# Rails Disco support
+gem 'rails-disco', '~> #{RailsDisco::VERSION::STRING}'\n
+# Required Multithreaded Webserver
+gem 'puma'\n" unless behavior == :revoke
+    end
+
+    def app
+      super
+      copy_file 'app/controllers/event_source_controller.rb'
+      keep_file 'app/commands'
+      keep_file 'app/events'
+      keep_file 'app/projections'
+      keep_file 'app/validations'
+
+      keep_file 'domain/command_processors/domain'
+      keep_file 'domain/models/domain'
+      keep_file 'domain/projections/domain'
+      keep_file 'domain/validations/domain'
+    end
+
+    def bin
+      super
+      copy_file 'bin/disco'
+      chmod 'bin/disco', 0755, verbose: false
+    end
+
+    def config
+      super
+      inside 'config/initializers' do
+        template 'create_domain.rb'
+        copy_file 'build_validations_registry.rb'
+      end
+    end
+
+    def database_yml
+      super
+      template 'config/disco.yml'
+    end
+
+    def db
+      super
+      append_file 'db/seeds.rb', File.binread(File.expand_path('../templates/db/seeds.rb', __FILE__)) unless behavior == :revoke
+    end
+  end
+
+  module Generators
+    class AppGenerator < Rails::Generators::AppGenerator
+      remove_class_option :version
+      class_option :version, type: :boolean, aliases: '-v', group: :disco,
+                   desc: 'Show Rails Disco version number and quit'
+
+      remove_class_option :help
+      class_option :help, type: :boolean, aliases: '-h', group: :disco,
+                   desc: 'Show this help message and quit'
+
+      # this does not seem to work !
+      remove_command :apply_rails_template, :run_bundle
+
+      def source_paths
+        [File.join(Gem::Specification.find_by_name('railties').gem_dir, 'lib/rails/generators/rails/app/templates'), File.expand_path('../templates', __FILE__)]
+      end
+
+      def add_event_source_route
+        return if behavior == :revoke
+        route "get 'event_stream' => 'event_source#stream'"
+      end
+
+      def enable_rake_tasks
+        return if behavior == :revoke
+        content = "
+require 'rails-disco/tasks'"
+        inject_into_file File.join('config/application.rb'), content, after: /require 'rails\/all'/
+      rescue Exception
+        puts "Seems like you invoked it from an engine, so put\n
+        require 'rails-disco/tasks'\n
+        in your application.rb from the main application to have the rails disco rake tasks available"
+      end
+
+      def enable_concurrency
+        return if behavior == :revoke
+        application 'config.preload_frameworks = true'
+        application 'config.allow_concurrency = true'
+      rescue Exception
+        puts "Seems like you invoked it from an engine, so remember to put\n
+        config.preload_frameworks = true
+        config.allow_concurrency = true\n
+        in your application.rb from the main application"
+      end
+
+      public_task :apply_rails_template, :run_bundle
+
+      protected
+
+      def self.banner
+        "disco new #{self.arguments.map(&:usage).join(' ')} [options]"
+      end
+
+      private
+
+      def get_builder_class
+        defined?(::AppBuilder) ? ::AppBuilder : Disco::AppBuilder
+      end
+
+      def domain_database(env, indent_level)
+        config = YAML.load(File.read('config/database.yml'))[env.to_s]
+        config['database'].sub!(/.*#{env}/, '\0_domain')
+        indent( ({'domain_database' => config}.to_yaml(indentation: 2))[4..-1], indent_level)
+      end
+
+      # copied namespace support from NamedBase
+      def module_namespacing(&block)
+        content = capture(&block)
+        content = wrap_with_namespace(content) if namespace
+        concat(content)
+      end
+
+      def indent(content, multiplier = 2)
+        spaces = ' ' * multiplier
+        content.each_line.map {|line| line.blank? ? line : "#{spaces}#{line}" }.join
+      end
+
+      def wrap_with_namespace(content)
+        content = indent(content).chomp
+        "module #{namespace.name}\n#{content}\nend\n"
+      end
+
+      def namespace
+        Rails::Generators.namespace
+      end
+    end
+  end
+end

data/lib/generators/disco/app/templates/app/controllers/event_source_controller.rb

@@ -0,0 +1,16 @@
+class EventSourceController < ApplicationController
+  include ActionController::Live
+  include ActiveEvent::EventSourceServer
+
+  def stream
+    event_connection.start
+    response.headers['Content-Type'] = 'text/event-stream'
+    sse = ActiveEvent::SSE.new(response.stream)
+    subscribe_to event_queue do |delivery_info, properties, body|
+      sse.write({:id => body}, :event => 'refresh')
+    end
+  rescue IOError
+  ensure
+    sse.close
+  end
+end

data/lib/generators/disco/app/templates/bin/disco

@@ -0,0 +1,3 @@
+APP_PATH = File.expand_path('../../config/application',  __FILE__)
+require_relative '../config/boot'
+require 'disco/commands'

data/lib/generators/disco/app/templates/config/disco.yml

@@ -0,0 +1,27 @@
+development:
+<%= domain_database(:development, 2) -%>
+  drb_server:
+    scheme: druby
+    host: 127.0.0.1
+    port: 8787
+  event_connection:
+    scheme: amqp
+    host: 127.0.0.1
+    port: 5672
+  event_exchange: events
+
+test:
+<%= domain_database(:test, 2) -%>
+
+production:
+<%= domain_database(:production, 2) -%>
+  drb_server:
+    protocol: druby
+    host: 127.0.0.1
+    port: 8787
+  event_connection:
+    scheme: amqp
+    userinfo: amqp:password
+    host: 127.0.0.1
+    port: 9797
+  event_exchange: events

data/lib/generators/disco/app/templates/config/initializers/build_validations_registry.rb

@@ -0,0 +1,19 @@
+require 'active_event'
+require 'active_projection'
+ActiveEvent::Autoload.app_path = File.expand_path('../../..', __FILE__)
+ActiveProjection::Autoload.app_path = File.expand_path('../../..', __FILE__)
+LOGGER = ActiveEvent::Support::MultiLogger.new 'Rails Server'
+
+watchable_dirs = ActiveEvent::Autoload.watchable_dirs.merge ActiveProjection::Autoload.watchable_dirs
+RELOADER = ActiveSupport::FileUpdateChecker.new([], watchable_dirs) do
+  ActiveEvent::Autoload.reload_module :ValidationsRegistry
+  ActiveEvent::Autoload.reload
+  ActiveProjection::Autoload.reload
+  ActiveEvent::ValidationsRegistry.build
+end
+
+ActionDispatch::Reloader.to_prepare do
+  RELOADER.execute_if_updated
+end
+
+ActiveEvent::ValidationsRegistry.build

data/lib/generators/disco/app/templates/config/initializers/create_domain.rb

@@ -0,0 +1,5 @@
+<% module_namespacing do -%>
+  class Domain
+    include ::ActiveEvent::Domain
+  end
+<% end -%>

data/lib/generators/disco/app/templates/db/seeds.rb

@@ -0,0 +1,14 @@
+#
+# With Rails Disco you can invoke domain commands
+#
+# Examples:
+#
+#   city_id = domain_run(CityCreateCommand.new(name: 'Chicago'))
+#   domain_run(MayorCreateCommand(name: 'Emanuel', city_id: city_id)
+@@can_run = true
+def domain_run(command)
+  Domain.run_command(command) if @@can_run
+rescue DRb::DRbConnError
+  puts 'no domain server for seeds'
+  @@can_run = false
+end

data/lib/generators/disco/command/USAGE

@@ -0,0 +1,11 @@
+Description:
+    Generates a Command, an Event and adds it to the CommandProcessor or creates one.
+
+Example:
+    rails generate disco:command CreateThing [attr1, attr2] --event=CreatedThing --processor=Things
+
+    This will create:
+        app/commands/create_thing_command.rb
+        app/events/created_thing_event.rb
+        domain/command_processors/things_processor.rb unless it exists
+        Adds a command handler to this or an existing processor