event_bg_bus 0.0.1 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. checksums.yaml +8 -8
  2. data/README.md +22 -13
  3. data/lib/event_bg_bus.rb +5 -1
  4. metadata +3 -3
checksums.yaml CHANGED
@@ -1,15 +1,15 @@
1
1
  ---
2
2
  !binary "U0hBMQ==":
3
3
  metadata.gz: !binary |-
4
- ZWIwZTQxNTY3YjBiYWYxMWUyOGE3MWJmMmZhZTAzZGMyNTc5NmYwYw==
4
+ MzY1OWZiMGZiNGRkMjkyY2YzZTdiMTE4NjZhODcyNTZhNTM4ZmVmNQ==
5
5
  data.tar.gz: !binary |-
6
- M2NjYzhiOTIwMzE2MDIxN2M1ZTRjZTYyM2I0YmYyZWMxMDllN2E2ZQ==
6
+ YjcwZGQwZGM4Y2Y4MzRmNzMwOTEzZTgwYjA5MjZjMDQ5YjExNDM2Mw==
7
7
  SHA512:
8
8
  metadata.gz: !binary |-
9
- NmVmZDBhZjE3NTE2Y2JjMTJhOGM4YWMzMTQ3NzVhNmE0ZDJlMzcwYzQ1OWU2
10
- YmQ1YWY0MTNkMzk5MjE4N2QxY2U1YTk4YzM0NWYzM2MyNWFjMTA4ZjdjOTVl
11
- Y2IxMzBmMDlkMWU0MWQ3N2Q1NDEyMGI2NzE5YThkMTBhMTVlODk=
9
+ MDkzZTY1ZDNjNmQ4MmZkNWIxYmZhYzEwMmY4ZmFlYWI4N2FkYTVjMGQ1MTRi
10
+ OTMwYzZhNzM3MTA2NTcwYTNmMGE4YmQzYTViOTI4YmIxMDllZTczNTkwNmYz
11
+ YTkwMTJlY2I3MmI4MDU5ZGFiYmM1ZmQxMTBhOWI4YmMxMGE4OTg=
12
12
  data.tar.gz: !binary |-
13
- ZTUxYzRiYWFhMjJiYzlmMWQ3NjVmMjZhODFiNWI3YjljNTNkYTUzODAxMDg0
14
- MjdiZWI3OTY1YWQyY2ViZmE4OWZlMWQ3OWI0NTE0ODE0NmJjNTFjMzAxZDY2
15
- YTlmODgxYjg0NTZmZGQzNzkwMmY0ZjRmOThmOTllZjA1ZmJhYTc=
13
+ NDk0Y2Q1OWE2NjJlYmIzZWE2YWNlMzFjMDg3MDA5YTY2NzY1ODEzNzBhYTkz
14
+ ODZmZjE2ZGEyY2VhMDdkNGE4MDg4NzdmNDFiOWFiYmQ1YzZiNGM1YmM0Njlm
15
+ NGMzMTM4MDg4NWM2YWVkMzNiMWVkNzUxMzU2MWUyOTcwMzM4ODA=
data/README.md CHANGED
@@ -3,8 +3,11 @@
3
3
  A simple pubsub event bus for Ruby applications.
4
4
 
5
5
  [![Build Status](https://travis-ci.org/artmees/event_bus.svg?branch=master)](https://travis-ci.org/artmees/event_bus)
6
+ [![Code Climate](https://codeclimate.com/github/artmees/event_bus.png)](https://codeclimate.com/github/artmees/event_bus)
6
7
 
7
- * Source code: <https://github.com/artmees/event_bus>
8
+ * Gem: <https://rubygems.org/gems/event_bg_bus>
9
+ * Docs: <http://rubydoc.info/github/artmees/event_bg_bus/master/frames>
10
+ * Source code: <https://github.com/artmees/event_bg_bus>
8
11
 
9
12
  ## Features
10
13
 
@@ -18,10 +21,17 @@ A simple pubsub event bus for Ruby applications.
18
21
 
19
22
  ## Installation
20
23
 
24
+ Install the gem
25
+ ```
26
+ gem install 'event_bg_bus'
27
+ ```
28
+
21
29
  Add it to your Gemfile and run `bundle`.
22
30
 
23
31
  ``` ruby
24
32
  gem 'event_bus', github: 'artmees/event_bus'
33
+ # or
34
+ gem 'event_bg_bus'
25
35
  ```
26
36
 
27
37
  ## Usage
@@ -121,21 +131,20 @@ There are three ways to subscribe to events.
121
131
 
122
132
  #### Subscribe to background published events
123
133
 
124
- due to a limitation using [Sidekiq](https://github.com/mperham/sidekiq),
125
- you can not subscribe to events published using `bg_announce` using Symbols in either `event_name` or `payload`.
134
+ due to some [Sidekiq](https://github.com/mperham/sidekiq) limitations with background jobs.
135
+ you can not subscribe to events published by `EventBGBus` using Symbols in either `event_name` or `payload`.
126
136
  you can via Reqexp, Strings or listener objects.
127
137
 
138
+ ```ruby
139
+ EventBus.subscribe('order_placed', StatsRecorder.new, :print_order)
140
+ ```
128
141
 
129
- ```ruby
130
- EventBus.subscribe('order_placed', StatsRecorder.new, :print_order)
131
- ```
132
-
133
- ```ruby
134
- EventBus.subscribe('order_placed') do |payload|
135
- order = payload['order']
136
- //...
137
- end
138
- ```
142
+ ```ruby
143
+ EventBus.subscribe('order_placed') do |payload|
144
+ order = payload['order']
145
+ //...
146
+ end
147
+ ```
139
148
 
140
149
  See the specs for more detailed usage scenarios.
141
150
 
@@ -10,9 +10,13 @@ class EventBGBus
10
10
  # The +event_name+ is added to the +payload+ hash (with the key +"event_name"+)
11
11
  # before being passed on to listeners.
12
12
  #
13
+ # note that the +payload+ hash won't be accessed using the symbol syntax
14
+ # so instead of using +payload[:param]+ you can only use +payload['param']
15
+ # this is due to sidekiq limitation with background jobs
16
+ #
13
17
  # @param event_name [String, Symbol] the name of your event
14
18
  # @param payload [Hash] the information you want to pass to the listeners
15
- # @return [EventBus] the EventBus, ready to be called again.
19
+ # @return [EventBGBus] the EventBGBus, ready to be called again.
16
20
  #
17
21
  def publish(event_name, payload = {})
18
22
  case event_name
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: event_bg_bus
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.0.1
4
+ version: 0.0.2
5
5
  platform: ruby
6
6
  authors:
7
7
  - Kevin Rutherford
@@ -9,7 +9,7 @@ authors:
9
9
  autorequire:
10
10
  bindir: bin
11
11
  cert_chain: []
12
- date: 2014-04-01 00:00:00.000000000 Z
12
+ date: 2014-04-02 00:00:00.000000000 Z
13
13
  dependencies:
14
14
  - !ruby/object:Gem::Dependency
15
15
  name: rake
@@ -89,7 +89,7 @@ files:
89
89
  - spec/lib/event_bg_bus_spec.rb
90
90
  - spec/lib/event_bus_spec.rb
91
91
  - spec/spec_helper.rb
92
- homepage: http://github.com/artmees/event_bus
92
+ homepage: http://github.com/artmees/event_bg_bus
93
93
  licenses: []
94
94
  metadata: {}
95
95
  post_install_message: