houston-conversations 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ae170cd102e0f0da8a1c7e9762ee3807fae8f916
+  data.tar.gz: 9e36c20c17883eacf58049f51c02014dc32837ce
+SHA512:
+  metadata.gz: 8281eeecc1e0a925df53411b25222f99909fbe76e4b3bbca3fb20106b4731a74aa13d7ecda628b00cdd1a0aaa96018983819cbddc1bad292b81bda3ada2463bd
+  data.tar.gz: 77b1d12b78cd6396f2bac0a7dcade7a93e3c6283ed44226e131ef0077f6d0bb28172ab7fb69eb3300aac66bba31f21c538a4a9022132a5db048097a6d62655de

data/.gitignore

@@ -0,0 +1,4 @@
+.bundle/
+log/*.log
+pkg/
+tmp/

data/Gemfile

@@ -0,0 +1,24 @@
+source "https://rubygems.org"
+
+# Declare your gem's dependencies in houston-conversations.gemspec.
+# Bundler will treat runtime dependencies like base dependencies, and
+# development dependencies will be added by default to the :development group.
+gemspec
+
+# Declare any dependencies that are still in development here instead of in
+# your gemspec. These might include edge Rails or gems from your path or
+# Git. Remember to move these dependencies to your gemspec before releasing
+# your gem to rubygems.org.
+
+group :development, :test do
+  gem "pry"
+end
+
+group :test do
+  gem "minitest"
+  gem "capybara"
+  gem "shoulda-context"
+
+  gem "minitest-reporters", require: false
+  gem "minitest-reporters-turn_reporter", require: false
+end

data/Gemfile.lock

@@ -0,0 +1,351 @@
+PATH
+  remote: .
+  specs:
+    houston-conversations (0.1.0)
+      attentive
+      concurrent-ruby
+      houston-core (>= 0.7.0.beta3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionmailer (4.2.5.2)
+      actionpack (= 4.2.5.2)
+      actionview (= 4.2.5.2)
+      activejob (= 4.2.5.2)
+      mail (~> 2.5, >= 2.5.4)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+    actionpack (4.2.5.2)
+      actionview (= 4.2.5.2)
+      activesupport (= 4.2.5.2)
+      rack (~> 1.6)
+      rack-test (~> 0.6.2)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (4.2.5.2)
+      activesupport (= 4.2.5.2)
+      builder (~> 3.1)
+      erubis (~> 2.7.0)
+      rails-dom-testing (~> 1.0, >= 1.0.5)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    activejob (4.2.5.2)
+      activesupport (= 4.2.5.2)
+      globalid (>= 0.3.0)
+    activemodel (4.2.5.2)
+      activesupport (= 4.2.5.2)
+      builder (~> 3.1)
+    activerecord (4.2.5.2)
+      activemodel (= 4.2.5.2)
+      activesupport (= 4.2.5.2)
+      arel (~> 6.0)
+    activerecord-import (0.14.1)
+      activerecord (>= 3.2)
+    activerecord-pluck_in_batches (0.1.1)
+      activerecord
+    activesupport (4.2.5.2)
+      i18n (~> 0.7)
+      json (~> 1.7, >= 1.7.7)
+      minitest (~> 5.1)
+      thread_safe (~> 0.3, >= 0.3.4)
+      tzinfo (~> 1.1)
+    addressable (2.3.8)
+    ansi (1.5.0)
+    arel (6.0.3)
+    attentive (0.3.2)
+      thread_safe
+    bcrypt (3.1.11)
+    boblail-unfuddle (0.7.1)
+      activesupport
+      builder
+      faraday (>= 0.8, < 0.10)
+    browser (1.1.0)
+    builder (3.2.2)
+    cancan (1.6.10)
+    capybara (2.7.1)
+      addressable
+      mime-types (>= 1.16)
+      nokogiri (>= 1.3.3)
+      rack (>= 1.0.0)
+      rack-test (>= 0.5.4)
+      xpath (~> 2.0)
+    chronic (0.10.2)
+    codeclimate-test-reporter (0.4.8)
+      simplecov (>= 0.7.1, < 1.0.0)
+    coderay (1.1.1)
+    coffee-rails (4.1.1)
+      coffee-script (>= 2.2.0)
+      railties (>= 4.0.0, < 5.1.x)
+    coffee-script (2.4.1)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.10.0)
+    concurrent-ruby (1.0.2)
+    css_parser (1.4.5)
+      addressable
+    default_value_for (3.0.1)
+      activerecord (>= 3.2.0, < 5.0)
+    devise (3.5.10)
+      bcrypt (~> 3.0)
+      orm_adapter (~> 0.1)
+      railties (>= 3.2.6, < 5)
+      responders
+      thread_safe (~> 0.1)
+      warden (~> 1.2.3)
+    devise_invitable (1.5.5)
+      actionmailer (>= 3.2.6, < 5)
+      devise (>= 3.2.0)
+    docile (1.1.5)
+    domain_name (0.5.20160615)
+      unf (>= 0.0.5, < 1.0.0)
+    engineyard (3.2.1)
+      engineyard-cloud-client (~> 2.1)
+      engineyard-serverside-adapter (~> 2.2)
+      escape (~> 0.0.4)
+      highline (~> 1.6.1)
+      launchy (~> 2.1)
+      net-ssh (~> 2.7)
+    engineyard-cloud-client (2.1.1)
+      multi_json (~> 1.6)
+      rest-client (~> 1.7)
+    engineyard-serverside-adapter (2.4.0)
+      escape (~> 0.0.4)
+      multi_json (~> 1.6)
+    erubis (2.7.0)
+    escape (0.0.4)
+    execjs (2.7.0)
+    faraday (0.9.2)
+      multipart-post (>= 1.2, < 3)
+    faraday-http-cache (1.2.2)
+      faraday (~> 0.8)
+    faraday-raise-errors (0.2.0)
+      faraday
+    gemoji (2.1.0)
+    globalid (0.3.6)
+      activesupport (>= 4.1.0)
+    googlecharts (1.6.12)
+    handlebars_assets (0.23.0)
+      execjs (~> 2.0)
+      multi_json (~> 1.0)
+      sprockets (>= 2.0.0)
+      tilt (>= 1.2)
+    highline (1.6.21)
+    houston-core (0.7.0.beta3)
+      activerecord-import
+      activerecord-pluck_in_batches
+      addressable (~> 2.3.8)
+      boblail-unfuddle
+      browser (~> 1.1.0)
+      bundler
+      cancan (~> 1.6.10)
+      codeclimate-test-reporter (= 0.4.8)
+      coffee-rails (~> 4.1.0)
+      default_value_for (= 3.0.1)
+      devise (~> 3.5.0)
+      devise_invitable (~> 1.5.3)
+      engineyard (~> 3.2.1)
+      faraday (~> 0.9.2)
+      faraday-http-cache (~> 1.2.2)
+      faraday-raise-errors (~> 0.2.0)
+      gemoji (~> 2.1.0)
+      googlecharts (~> 1.6.12)
+      handlebars_assets (~> 0.23.0)
+      houston-devise_ldap_authenticatable
+      houston-vestal_versions
+      hpricot (~> 0.8.6)
+      neat-rails
+      nested_editor_for
+      nokogiri
+      oauth2
+      octokit (~> 4.3.0)
+      oj (~> 2.13)
+      openxml-xlsx (>= 0.2.0)
+      pg (~> 0.18.3)
+      pg_search (~> 1.0.5)
+      premailer (~> 1.8.6)
+      progressbar
+      rack-utf8_sanitizer (~> 1.3.1)
+      rails (~> 4.2.5.1)
+      redcarpet (~> 3.3.2)
+      rufus-scheduler (~> 3.2.0)
+      rugged (~> 0.24.0)
+      sass-rails (~> 5.0)
+      simplecov (~> 0.9.1)
+      strongbox (~> 0.7.2)
+      thor
+      thread_safe (~> 0.3.5)
+      uglifier (>= 2.7.2)
+      whenever (= 0.9.2)
+    houston-devise_ldap_authenticatable (0.7.1)
+      devise (>= 3.0.0)
+      net-ldap (~> 0.12.1)
+    houston-vestal_versions (2.0.0)
+      activerecord (>= 3, < 5)
+      activesupport (>= 3, < 5)
+    hpricot (0.8.6)
+    htmlentities (4.3.4)
+    http-cookie (1.0.2)
+      domain_name (~> 0.5)
+    i18n (0.7.0)
+    json (1.8.3)
+    jwt (1.5.4)
+    launchy (2.4.3)
+      addressable (~> 2.3)
+    loofah (2.0.3)
+      nokogiri (>= 1.5.9)
+    mail (2.6.4)
+      mime-types (>= 1.16, < 4)
+    method_source (0.8.2)
+    mime-types (2.99.2)
+    mini_portile2 (2.1.0)
+    minitest (5.9.0)
+    minitest-reporters (1.1.9)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    minitest-reporters-turn_reporter (0.1.0)
+      minitest-reporters
+    multi_json (1.12.1)
+    multi_xml (0.5.5)
+    multipart-post (2.0.0)
+    neat-rails (0.5.0)
+    nested_editor_for (0.1.0)
+    net-ldap (0.12.1)
+    net-ssh (2.9.4)
+    netrc (0.11.0)
+    nokogiri (1.6.8)
+      mini_portile2 (~> 2.1.0)
+      pkg-config (~> 1.1.7)
+    oauth2 (1.2.0)
+      faraday (>= 0.8, < 0.10)
+      jwt (~> 1.0)
+      multi_json (~> 1.3)
+      multi_xml (~> 0.5)
+      rack (>= 1.2, < 3)
+    octokit (4.3.0)
+      sawyer (~> 0.7.0, >= 0.5.3)
+    oj (2.16.1)
+    openxml-package (0.2.4)
+      nokogiri
+      ox
+      rubyzip (~> 1.1.0)
+    openxml-xlsx (0.2.3)
+      nokogiri
+      openxml-package (>= 0.2.0)
+    orm_adapter (0.5.0)
+    ox (2.4.3)
+    pg (0.18.4)
+    pg_search (1.0.6)
+      activerecord (>= 3.1)
+      activesupport (>= 3.1)
+      arel
+    pkg-config (1.1.7)
+    premailer (1.8.7)
+      css_parser (>= 1.4.5)
+      htmlentities (>= 4.0.0)
+    progressbar (0.21.0)
+    pry (0.10.3)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    rack (1.6.4)
+    rack-test (0.6.3)
+      rack (>= 1.0)
+    rack-utf8_sanitizer (1.3.2)
+      rack (>= 1.0, < 3.0)
+    rails (4.2.5.2)
+      actionmailer (= 4.2.5.2)
+      actionpack (= 4.2.5.2)
+      actionview (= 4.2.5.2)
+      activejob (= 4.2.5.2)
+      activemodel (= 4.2.5.2)
+      activerecord (= 4.2.5.2)
+      activesupport (= 4.2.5.2)
+      bundler (>= 1.3.0, < 2.0)
+      railties (= 4.2.5.2)
+      sprockets-rails
+    rails-deprecated_sanitizer (1.0.3)
+      activesupport (>= 4.2.0.alpha)
+    rails-dom-testing (1.0.7)
+      activesupport (>= 4.2.0.beta, < 5.0)
+      nokogiri (~> 1.6.0)
+      rails-deprecated_sanitizer (>= 1.0.1)
+    rails-html-sanitizer (1.0.3)
+      loofah (~> 2.0)
+    railties (4.2.5.2)
+      actionpack (= 4.2.5.2)
+      activesupport (= 4.2.5.2)
+      rake (>= 0.8.7)
+      thor (>= 0.18.1, < 2.0)
+    rake (10.5.0)
+    redcarpet (3.3.4)
+    responders (2.2.0)
+      railties (>= 4.2.0, < 5.1)
+    rest-client (1.8.0)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
+    ruby-progressbar (1.8.1)
+    rubyzip (1.1.7)
+    rufus-scheduler (3.2.1)
+    rugged (0.24.0)
+    sass (3.4.22)
+    sass-rails (5.0.5)
+      railties (>= 4.0.0, < 6)
+      sass (~> 3.1)
+      sprockets (>= 2.8, < 4.0)
+      sprockets-rails (>= 2.0, < 4.0)
+      tilt (>= 1.1, < 3)
+    sawyer (0.7.0)
+      addressable (>= 2.3.5, < 2.5)
+      faraday (~> 0.8, < 0.10)
+    shoulda-context (1.2.1)
+    simplecov (0.9.2)
+      docile (~> 1.1.0)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.9.0)
+    simplecov-html (0.9.0)
+    slop (3.6.0)
+    sprockets (3.6.3)
+      concurrent-ruby (~> 1.0)
+      rack (> 1, < 3)
+    sprockets-rails (3.1.1)
+      actionpack (>= 4.0)
+      activesupport (>= 4.0)
+      sprockets (>= 3.0.0)
+    strongbox (0.7.2)
+      activerecord
+    thor (0.19.1)
+    thread_safe (0.3.5)
+    tilt (2.0.5)
+    tzinfo (1.2.2)
+      thread_safe (~> 0.1)
+    uglifier (3.0.0)
+      execjs (>= 0.3.0, < 3)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.7.2)
+    warden (1.2.6)
+      rack (>= 1.0)
+    whenever (0.9.2)
+      activesupport (>= 2.3.4)
+      chronic (>= 0.6.3)
+    xpath (2.0.0)
+      nokogiri (~> 1.3)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.11.2)
+  capybara
+  houston-conversations!
+  minitest
+  minitest-reporters
+  minitest-reporters-turn_reporter
+  pry
+  rake (~> 10.0)
+  shoulda-context
+
+BUNDLED WITH
+   1.11.2

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2016 Bob Lail
+
+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,31 @@
+# Houston::Conversations
+
+TODO: Summary of Houston Conversations.
+
+
+## Installation
+
+In your `Gemfile`, add:
+
+    gem "houston-conversations"
+
+And in `config/main.rb`, add:
+
+```ruby
+use :conversations do
+  # TODO: specify configuration options for Houston::Conversations here
+end
+```
+
+And then execute:
+
+    $ bundle
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,25 @@
+begin
+  require "bundler/setup"
+rescue LoadError
+  puts "You must `gem install bundler` and `bundle install` to run rake tasks"
+end
+
+
+# `rake test` and `rake test:all` are loaded from Houston
+require_relative "test/dummy/houston"
+Houston::Application.load_tasks
+
+
+require "rdoc/task"
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = "rdoc"
+  rdoc.title    = "Conversations"
+  rdoc.options << "--line-numbers"
+  rdoc.rdoc_files.include("README.rdoc")
+  rdoc.rdoc_files.include("lib/**/*.rb")
+end
+
+
+Bundler::GemHelper.install_tasks
+

data/app/assets/javascripts/houston/conversations/application.js

@@ -0,0 +1,13 @@
+// This is a manifest file that'll be compiled into application.js, which will include all the files
+// listed below.
+//
+// Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
+// or vendor/assets/javascripts of plugins, if any, can be referenced here using a relative path.
+//
+// It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
+// the compiled file.
+//
+// WARNING: THE FIRST BLANK LINE MARKS THE END OF WHAT'S TO BE PROCESSED, ANY BLANK LINE SHOULD
+// GO AFTER THE REQUIRES BELOW.
+//
+//= require_tree .

data/app/assets/stylesheets/houston/conversations/application.css

@@ -0,0 +1,13 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or vendor/assets/stylesheets of plugins, if any, can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the top of the
+ * compiled file, but it's generally better to create a new file per style scope.
+ *
+ *= require_self
+ *= require_tree .
+ */

data/app/controllers/houston/conversations/application_controller.rb

@@ -0,0 +1,4 @@
+module Houston::Conversations
+  class ApplicationController < ActionController::Base
+  end
+end

data/app/helpers/houston/conversations/application_helper.rb

@@ -0,0 +1,4 @@
+module Houston::Conversations
+  module ApplicationHelper
+  end
+end

data/app/views/layouts/houston/conversations/application.html.erb

@@ -0,0 +1,10 @@
+<% content_for :stylesheets do %>
+  <%= stylesheet_link_tag    "houston/conversations/application", :media => "all" %>
+<% end %>
+
+<% content_for :javascripts do %>
+  <%= javascript_include_tag "houston/conversations/application" %>
+<% end %>
+
+<%# Houston's default layout %>
+<%= render template: "layouts/application" %>

data/bin/rails

@@ -0,0 +1,8 @@
+#!/usr/bin/env ruby
+# This command will automatically be run when you run "rails" with Rails 4 gems installed from the root of your application.
+
+ENGINE_ROOT = File.expand_path('../..', __FILE__)
+ENGINE_PATH = File.expand_path('../../lib/houston/conversations/engine', __FILE__)
+
+require 'rails/all'
+require 'rails/engine/commands'

data/config/database.yml

@@ -0,0 +1,13 @@
+development:
+  adapter: postgresql
+  encoding: utf8
+  database: houston_conversations_development
+  host: localhost
+  prepared_statements: false
+
+test:
+  adapter: postgresql
+  encoding: utf8
+  database: houston_conversations_test
+  host: localhost
+  prepared_statements: false

data/config/initializers/add_navigation_renderer.rb

@@ -0,0 +1,3 @@
+# Houston.add_navigation_renderer :conversations do
+#  render_nav_link "Conversations", Houston::Conversations::Engine.routes.url_helpers.root_path, icon: "fa-thumbs-up"
+# end

data/config/routes.rb

@@ -0,0 +1,2 @@
+Houston::Conversations::Engine.routes.draw do
+end

data/houston-conversations.gemspec

@@ -0,0 +1,27 @@
+$:.push File.expand_path("../lib", __FILE__)
+
+# Maintain your gem's version:
+require "houston/conversations/version"
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |spec|
+  spec.name          = "houston-conversations"
+  spec.version       = Houston::Conversations::VERSION
+  spec.authors       = ["Bob Lail"]
+  spec.email         = ["bob.lailfamily@gmail.com"]
+
+  spec.summary       = "Allows Houston to have conversations"
+  spec.description   = "Describes a DSL for modeling conversations; supports pluggable backends"
+  spec.homepage      = "https://github.com/houston/houston-conversations"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.require_paths = ["lib"]
+  spec.test_files = Dir["test/**/*"]
+
+  spec.add_dependency "houston-core", ">= 0.7.0.beta3"
+  spec.add_dependency "attentive"
+  spec.add_dependency "concurrent-ruby"
+
+  spec.add_development_dependency "bundler", "~> 1.11.2"
+  spec.add_development_dependency "rake", "~> 10.0"
+end

data/lib/houston-conversations.rb

@@ -0,0 +1 @@
+require "houston/conversations"

data/lib/houston/conversations.rb

@@ -0,0 +1,56 @@
+require "houston/conversations/engine"
+require "houston/conversations/configuration"
+require "houston/conversations/listener_collection"
+require "houston/conversations/message"
+require "houston/conversations/event"
+
+module Houston
+  module Conversations
+    extend self
+
+    def config(&block)
+      @configuration ||= Conversations::Configuration.new
+      @configuration.instance_eval(&block) if block_given?
+      @configuration
+    end
+
+    def listeners
+      @listeners ||= Houston::Conversations::ListenerCollection.new
+    end
+
+    # Matches a message against all listeners
+    # and invokes the first listener that mathes
+    def hear(message, params={})
+      raise ArgumentError, "`message` is a #{message.class.name} but must be a subclass of Houston::Conversations::Message" unless message.is_a?(Houston::Conversations::Message)
+
+      listeners.hear(message).each do |match|
+
+        event = Houston::Conversations::Event.new(match)
+        yield event if block_given?
+        invoke! match.listener, event
+
+        # Invoke only one listener per message
+        return true
+      end
+
+      false
+    end
+
+  private
+
+    def invoke!(listener, event)
+      Rails.logger.debug "\e[35m[conversations:hear] #{event.message}\e[0m"
+
+      Houston.async do
+        begin
+          listener.call(event)
+        rescue Exception # rescues StandardError by default; but we want to rescue and report all errors
+          Houston.report_exception $!, parameters: event.to_h
+          Rails.logger.error "\e[31m[conversations:exception] (#{$!.class}) #{$!.message}\n  #{$!.backtrace.join("\n  ")}\e[0m"
+          event.reply "An error occurred when I was trying to answer you"
+        end
+      end
+    end
+
+  end
+end

data/lib/houston/conversations/configuration.rb

@@ -0,0 +1,14 @@
+module Houston::Conversations
+  class Configuration
+
+
+    def listen_for(*args, &block)
+      Houston::Conversations.listeners.listen_for(*args, &block)
+    end
+
+    def overhear(*args, &block)
+      Houston::Conversations.listeners.overhear(*args, &block)
+    end
+
+  end
+end

data/lib/houston/conversations/conversation.rb

@@ -0,0 +1,47 @@
+require "concurrent/array"
+
+module Houston
+  module Slack
+    class Conversation
+
+      def initialize(channel, sender)
+        @channel = channel
+        @sender = sender
+        @listeners = Concurrent::Array.new
+      end
+
+      def listen_for(*args, &block)
+        Houston::Conversations.listen_for(*args, &block).tap do |listener|
+          listener.conversation = self
+          listeners.push listener
+        end
+      end
+
+      def includes?(e)
+        e.channel == channel && e.sender == sender
+      end
+
+      def reply(*messages)
+        channel.reply(*messages)
+      end
+      alias :say :reply
+
+      def ask(question, expect: nil)
+        listen_for(*Array(expect)) do |e|
+          e.stop_listening!
+          yield e
+        end
+
+        reply question
+      end
+
+      def end!
+        listeners.each(&:stop_listening!)
+      end
+
+    private
+      attr_reader :channel, :sender, :listeners
+
+    end
+  end
+end

data/lib/houston/conversations/engine.rb

@@ -0,0 +1,27 @@
+require "houston/conversations/railtie"
+
+module Houston
+  module Conversations
+    class Engine < ::Rails::Engine
+      isolate_namespace Houston::Conversations
+
+      # Precompile this modules assets
+      initializer :assets do |config|
+        Rails.application.config.assets.precompile += %w(
+          houston/conversations/application.js
+          houston/conversations/application.css )
+      end
+
+      # Include the Engine's migrations with the Application
+      # http://pivotallabs.com/leave-your-migrations-in-your-rails-engines/
+      initializer :append_migrations do |app|
+        unless app.root.to_s.match root.to_s
+          config.paths["db/migrate"].expanded.each do |expanded_path|
+            app.config.paths["db/migrate"] << expanded_path
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/houston/conversations/event.rb

@@ -0,0 +1,80 @@
+require "houston/conversations/conversation"
+
+module Houston
+  module Conversations
+    class Event
+      attr_reader :match
+
+      def initialize(match)
+        @match = match
+      end
+
+
+
+      def message
+        match.message
+      end
+
+      def channel
+        message.channel
+      end
+
+      def sender
+        message.sender
+      end
+
+      def user
+        sender.user
+      end
+
+
+
+      def matched?(key)
+        match.matched?(key)
+      end
+
+      def stop_listening!
+        listener.stop_listening!
+      end
+
+      def responding
+        # do nothing; specific backends can implement the appropriate action
+      end
+
+      def reply(*args)
+        channel.reply(*args)
+      end
+
+      def random_reply(replies)
+        if replies.is_a?(Hash)
+          weights = replies.values
+          unless weights.reduce(&:+) == 1.0
+            raise ArgumentError, "Reply weights don't add up to 1.0"
+          end
+
+          draw = rand
+          sum = 0
+          pick = nil
+          replies.each do |reply, weight|
+            pick = reply unless sum > draw
+            sum += weight
+          end
+          reply pick
+        else
+          reply replies.sample
+        end
+      end
+
+      def start_conversation!
+        Conversation.new(channel, sender)
+      end
+
+
+
+      def to_h
+        { channel: channel, message: message, sender: sender }
+      end
+
+    end
+  end
+end

data/lib/houston/conversations/listener.rb

@@ -0,0 +1,19 @@
+require "attentive/listener"
+
+module Houston
+  module Conversations
+    class Listener < Attentive::Listener
+      attr_accessor :conversation
+
+      def matches_context?(message)
+        contexts = message.contexts.dup
+        contexts << :conversation if conversation && conversation.includes?(message)
+
+        return false unless contexts.superset? @required_contexts
+        return false unless contexts.disjoint? @prohibited_contexts
+        true
+      end
+
+    end
+  end
+end

data/lib/houston/conversations/listener_collection.rb

@@ -0,0 +1,24 @@
+require "attentive/listener_collection"
+require "houston/conversations/listener"
+
+module Houston
+  module Conversations
+    class ListenerCollection < Attentive::ListenerCollection
+
+      def overhear(*args, &block)
+        options = args.last.is_a?(::Hash) ? args.pop : {}
+        options[:context] = { in: :any }
+        listen_for(*args, options, &block)
+      end
+
+      def listen_for(*args, &block)
+        options = args.last.is_a?(::Hash) ? args.pop : {}
+
+        Houston::Conversations::Listener.new(self, args, options, block).tap do |listener|
+          push listener
+        end
+      end
+
+    end
+  end
+end

data/lib/houston/conversations/message.rb

@@ -0,0 +1,8 @@
+require "attentive/message"
+
+module Houston
+  module Conversations
+    class Message < ::Attentive::Message
+    end
+  end
+end

data/lib/houston/conversations/railtie.rb

@@ -0,0 +1,12 @@
+module Houston
+  module Conversations
+    class Railtie < ::Rails::Railtie
+
+      # The block you pass to this method will run for every request
+      # in development mode, but only once in production.
+      # config.to_prepare do
+      # end
+
+    end
+  end
+end

data/lib/houston/conversations/tty/channel.rb

@@ -0,0 +1,18 @@
+module Houston
+  module Conversations
+    module Tty
+      class Channel
+        attr_reader :session
+
+        def initialize(session)
+          @session = session
+        end
+
+        def reply(message)
+          session.say message
+        end
+
+      end
+    end
+  end
+end

data/lib/houston/conversations/tty/message.rb

@@ -0,0 +1,29 @@
+require "houston/conversations/message"
+require "houston/conversations/tty/channel"
+require "houston/conversations/tty/user"
+
+module Houston
+  module Conversations
+    module Tty
+      class Message < ::Houston::Conversations::Message
+        attr_reader :session
+
+        def initialize(session, text, params={})
+          @session = session
+          super text, params
+          contexts << :conversation
+          contexts << :tty
+        end
+
+        def channel
+          Houston::Conversations::Tty::Channel.new(session)
+        end
+
+        def sender
+          Houston::Conversations::Tty::User.new(session)
+        end
+
+      end
+    end
+  end
+end

data/lib/houston/conversations/tty/user.rb

@@ -0,0 +1,17 @@
+module Houston
+  module Conversations
+    module Tty
+      class User
+        attr_reader :session
+
+        def initialize(session)
+          @session = session
+        end
+
+        def user
+        end
+
+      end
+    end
+  end
+end

data/lib/houston/conversations/tty_session.rb

@@ -0,0 +1,33 @@
+require "houston/conversations/tty/message"
+require "etc"
+
+module Houston
+  module Conversations
+    class TtySession
+
+      def initialize(input=STDIN, output=STDOUT)
+        @input = input
+        @output = output
+        @prompt = "#{Etc.getlogin}> "
+      end
+
+      def listen!
+        output.print prompt
+        while text = input.gets
+          message = Houston::Conversations::Tty::Message.new(self, text)
+          unless Houston::Conversations.hear(message)
+            output.print prompt
+          end
+        end
+      end
+
+      def say(message)
+        output.puts "houston> #{message}"
+        output.print prompt
+      end
+
+    private
+      attr_reader :input, :output, :prompt
+    end
+  end
+end

data/lib/houston/conversations/version.rb

@@ -0,0 +1,5 @@
+module Houston
+  module Conversations
+    VERSION = "0.1.0"
+  end
+end

data/lib/tasks/conversations_tasks.rake

@@ -0,0 +1,6 @@
+require "houston/conversations/tty_session"
+
+desc "Test conversations with Houston"
+task :talk => :environment do
+  Houston::Conversations::TtySession.new.listen!
+end

data/test/acceptance/houston_dummy_test.rb

@@ -0,0 +1,17 @@
+require "test_helper"
+
+class DummyHoustonTest < ActionDispatch::IntegrationTest
+
+  context "The Test Suite" do
+    should "be able to interact with a dummy instance of Houston" do
+      visit "/users/sign_in"
+      fill_in "user_email", with: "admin@example.com"
+      fill_in "user_password", with: "password"
+      click_button "Sign in"
+
+      assert page.has_content?("Projects I Follow"),
+        "Expected to have been able to log in and to see the Timeline view"
+    end
+  end
+
+end

data/test/dummy/houston.rb

@@ -0,0 +1,23 @@
+# Load Houston
+require "houston/application"
+
+# Configure Houston
+Houston.config do
+
+  # Houston should load config/database.yml from this module
+  # rather than from Houston Core.
+  root Pathname.new File.expand_path("../../..",  __FILE__)
+
+  # Give dummy values to these required fields.
+  host "houston.test.com"
+  mailer_sender "houston@test.com"
+
+  # Houston still hard-codes knowledge of these Roles.
+  # This will eventually be refactored away.
+  roles "Developer", "Tester"
+  project_roles "Maintainer"
+
+  # Mount this module on the dummy Houston application.
+  use :conversations
+
+end

data/test/fixtures/projects.yml

@@ -0,0 +1,3 @@
+test:
+  name: Test
+  slug: test

data/test/fixtures/users.yml

@@ -0,0 +1,10 @@
+admin:
+  first_name: FirstName
+  last_name: LastName
+  email: admin@example.com
+  email_addresses:
+  - admin@example.com
+  administrator: true
+  role: Developer
+  encrypted_password: $2a$10$Pf9Q94yN7t/YGqGS6pBl5uOL8lUvqgWpGeXRMHGbgPU0ixbWzthOG
+# password: password

data/test/test_helper.rb

@@ -0,0 +1,43 @@
+# Configure Rails Environment
+ENV["RAILS_ENV"] = "test"
+
+# Load Houston
+require "dummy/houston"
+Rails.application.initialize! unless Rails.application.initialized?
+
+require "rails/test_help"
+
+if ENV["CI"] == "true"
+  require "minitest/reporters"
+  MiniTest::Reporters.use! [MiniTest::Reporters::DefaultReporter.new,
+                            MiniTest::Reporters::JUnitReporter.new]
+else
+  require "minitest/reporters/turn_reporter"
+  MiniTest::Reporters.use! Minitest::Reporters::TurnReporter.new
+end
+
+# Filter out Minitest backtrace while allowing backtrace
+# from other libraries to be shown.
+Minitest.backtrace_filter = Minitest::BacktraceFilter.new
+
+class ActiveSupport::TestCase
+
+  # Load fixtures from the engine
+  self.fixture_path = File.expand_path("../fixtures", __FILE__)
+
+  # Setup all fixtures in test/fixtures/*.yml for all tests in alphabetical order.
+  fixtures :all
+
+  # Add more helper methods to be used by all tests here...
+
+end
+
+require "capybara/rails"
+
+class ActionDispatch::IntegrationTest
+  include Capybara::DSL
+
+  # Load fixtures from the engine
+  self.fixture_path = File.expand_path("../fixtures", __FILE__)
+
+end

data/test/unit/fixtures_test.rb

@@ -0,0 +1,11 @@
+require "test_helper"
+
+class FixturesTest < ActiveSupport::TestCase
+
+  context "The Test Suite" do
+    should "load the fixtures defined in this engine" do
+      assert Project["test"], "Expected to find the 'test' project"
+    end
+  end
+
+end

metadata

@@ -0,0 +1,159 @@
+--- !ruby/object:Gem::Specification
+name: houston-conversations
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Bob Lail
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-07-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: houston-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.7.0.beta3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.7.0.beta3
+- !ruby/object:Gem::Dependency
+  name: attentive
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.11.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.11.2
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+description: Describes a DSL for modeling conversations; supports pluggable backends
+email:
+- bob.lailfamily@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/images/houston/conversations/.keep
+- app/assets/javascripts/houston/conversations/application.js
+- app/assets/stylesheets/houston/conversations/application.css
+- app/controllers/houston/conversations/application_controller.rb
+- app/helpers/houston/conversations/application_helper.rb
+- app/views/layouts/houston/conversations/application.html.erb
+- bin/rails
+- config/database.yml
+- config/initializers/add_navigation_renderer.rb
+- config/routes.rb
+- db/.keep
+- houston-conversations.gemspec
+- lib/houston-conversations.rb
+- lib/houston/conversations.rb
+- lib/houston/conversations/configuration.rb
+- lib/houston/conversations/conversation.rb
+- lib/houston/conversations/engine.rb
+- lib/houston/conversations/event.rb
+- lib/houston/conversations/listener.rb
+- lib/houston/conversations/listener_collection.rb
+- lib/houston/conversations/message.rb
+- lib/houston/conversations/railtie.rb
+- lib/houston/conversations/tty/channel.rb
+- lib/houston/conversations/tty/message.rb
+- lib/houston/conversations/tty/user.rb
+- lib/houston/conversations/tty_session.rb
+- lib/houston/conversations/version.rb
+- lib/tasks/conversations_tasks.rake
+- test/acceptance/houston_dummy_test.rb
+- test/dummy/houston.rb
+- test/fixtures/projects.yml
+- test/fixtures/users.yml
+- test/test_helper.rb
+- test/unit/fixtures_test.rb
+homepage: https://github.com/houston/houston-conversations
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Allows Houston to have conversations
+test_files:
+- test/acceptance/houston_dummy_test.rb
+- test/dummy/houston.rb
+- test/fixtures/projects.yml
+- test/fixtures/users.yml
+- test/test_helper.rb
+- test/unit/fixtures_test.rb