lita 2.5.0 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a0f46a0926eb20ff35d1597e8d7474e64984ffd4
-  data.tar.gz: 63b751e98f2e477e41b144da5c731160963d2377
+  metadata.gz: e05fe1e0cb321abc7f328ade3580833013f91650
+  data.tar.gz: 150331c84e76818a44f66f2759a965aed8d8fa75
 SHA512:
-  metadata.gz: 2f594e6d3301112d652d22b03c3f280c2560a7a86ab6868369d6240c3816cee6500db31c9737268850be6f04257c895baf27c4f06840a727ec95f93554d93824
-  data.tar.gz: 189688873d5ed9c3c110c0114b47ce94267ea4a7ea66f0c455652363f2433e18fed60e99ae792232e329eadb08f20ea6aeb77a2cb3eef4225f7412343582ec24
+  metadata.gz: af679c53aaa2fd86fedfa2c69b984d0961f9d7af73cf371a7c3a8148101dbae94396d078331b19fd2dcddaf1bd12b2bcf8e73dbed00bfbdda0134b3475ce8a2a
+  data.tar.gz: f61fd270bd693b01bc78ccd5e07062bf4838ca5265c25fa08394cf6b63f25a93fb48e655377b83b1f93a3550a86bd5ded52401d82a269b3d3d28a53261955df0

data/README.md

@@ -261,6 +261,14 @@ robot.trigger(:connected, room: "#litabot")
 
 Since the `trigger` method is available on `Lita::Robot`, it can be used from anywhere in the Lita runtime (both adapters and handlers).
 
+### Built-in events
+
+Lita has a few built-in events:
+
+* `:loaded` - Fired when the `Lita::Robot` object has been initialized during start up. This can be used as a hook point for handlers to define routes that depend on user configuration not known until runtime, run migrations on data in Redis, or other start up tasks.
+* `:shut_down_started` - Fired when the robot first begins shutting down.
+* `:shut_down_completed` - Fired when the robot has finished shutting down both the built-in web server and the chat adapter.
+
 ### Handler-specific configuration
 
 If you want your handler to expose config settings to the user, use the class-level `default_config` method. This method accepts a single config object as an argument, which will be exposed to the user as `Lita.config.handlers.your_handler_namespace`.

data/lib/lita/robot.rb

@@ -22,6 +22,7 @@ module Lita
       @mention_name = Lita.config.robot.mention_name || @name
       @app = RackApp.new(self).to_app
       load_adapter
+      trigger(:loaded)
     end
 
     # The primary entry point from the adapter for an incoming message.
@@ -66,9 +67,11 @@ module Lita
     # service.
     # @return [void]
     def shut_down
+      trigger(:shut_down_started)
       @server.stop if @server
       @server_thread.join if @server_thread
       @adapter.shut_down
+      trigger(:shut_down_complete)
     end
 
     # Triggers an event, instructing all registered handlers to invoke any

data/lib/lita/version.rb

@@ -1,4 +1,4 @@
 module Lita
   # The current version of Lita.
-  VERSION = "2.5.0"
+  VERSION = "2.6.0"
 end

data/lita.gemspec

@@ -20,16 +20,16 @@ Gem::Specification.new do |spec|
 
   spec.required_ruby_version = ">= 2.0.0"
 
-  spec.add_runtime_dependency "bundler", "~> 1.3"
-  spec.add_runtime_dependency "faraday", "~> 0.8.7"
-  spec.add_runtime_dependency "multi_json", "~> 1.7.7"
-  spec.add_runtime_dependency "rack", "~> 1.5.2"
-  spec.add_runtime_dependency "redis-namespace", "~> 1.3.0"
-  spec.add_runtime_dependency "thin", "~> 1.5.1"
-  spec.add_runtime_dependency "thor", "~> 0.18.1"
+  spec.add_runtime_dependency "bundler", ">= 1.3"
+  spec.add_runtime_dependency "faraday", ">= 0.8.7"
+  spec.add_runtime_dependency "multi_json", ">= 1.7.7"
+  spec.add_runtime_dependency "rack", ">= 1.5.2"
+  spec.add_runtime_dependency "redis-namespace", ">= 1.3.0"
+  spec.add_runtime_dependency "thin", ">= 1.5.1"
+  spec.add_runtime_dependency "thor", ">= 0.18.1"
 
   spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec", "~> 2.14"
+  spec.add_development_dependency "rspec", ">= 2.14"
   spec.add_development_dependency "simplecov"
   spec.add_development_dependency "coveralls"
   spec.add_development_dependency "pry"

data/spec/lita/robot_spec.rb

@@ -9,6 +9,11 @@ describe Lita::Robot do
     expect { subject }.to raise_error(SystemExit)
   end
 
+  it "triggers a loaded event after initialization" do
+    expect_any_instance_of(described_class).to receive(:trigger).with(:loaded)
+    subject
+  end
+
   context "with registered handlers" do
     let(:handler1) { double("Handler 1").as_null_object }
     let(:handler2) { double("Handler 2").as_null_object }
@@ -102,5 +107,11 @@ describe Lita::Robot do
       expect_any_instance_of(Lita::Adapters::Shell).to receive(:shut_down)
       subject.shut_down
     end
+
+    it "triggers events for shut_down_started and shut_down_complete" do
+      expect(subject).to receive(:trigger).with(:shut_down_started).ordered
+      expect(subject).to receive(:trigger).with(:shut_down_complete).ordered
+      subject.shut_down
+    end
   end
 end

metadata

@@ -1,111 +1,111 @@
 --- !ruby/object:Gem::Specification
 name: lita
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Jimmy Cuadra
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-05 00:00:00.000000000 Z
+date: 2013-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 0.8.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 0.8.7
 - !ruby/object:Gem::Dependency
   name: multi_json
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.7.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.7.7
 - !ruby/object:Gem::Dependency
   name: rack
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.5.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.5.2
 - !ruby/object:Gem::Dependency
   name: redis-namespace
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.3.0
 - !ruby/object:Gem::Dependency
   name: thin
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.5.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.5.1
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 0.18.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 0.18.1
 - !ruby/object:Gem::Dependency
@@ -126,14 +126,14 @@ dependencies:
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: '2.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: '2.14'
 - !ruby/object:Gem::Dependency