resource_subscriber 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: 4a9dae7ba936613f12121ad3a9f9410d0d2ab58b
4
+ data.tar.gz: b326e9c13469a191400a661e301a5021210aeb07
5
+ SHA512:
6
+ metadata.gz: 42ac1ee74dadc403cd5f9ec61ebd107fc19bd02f80c748cbd3dd1f7e7be55d0310d007ca4e6ab399a83206fec0743820f23c6e8c46fdf92891aa8e4a669597b9
7
+ data.tar.gz: 4541121bb3043aa70baf9b98045ec50dfb802bf859ab626059f518333827cd589a94cc2cf71a1a3afe1cd927bbc06f72719c761bef273cb7b8d99fa0d270ce26
data/.gitignore ADDED
@@ -0,0 +1,9 @@
1
+ /.bundle/
2
+ /.yardoc
3
+ /Gemfile.lock
4
+ /_yardoc/
5
+ /coverage/
6
+ /doc/
7
+ /pkg/
8
+ /spec/reports/
9
+ /tmp/
data/.rspec ADDED
@@ -0,0 +1,2 @@
1
+ --format documentation
2
+ --color
data/.travis.yml ADDED
@@ -0,0 +1,4 @@
1
+ language: ruby
2
+ rvm:
3
+ - 2.3.0
4
+ before_install: gem install bundler -v 1.11.2
data/Gemfile ADDED
@@ -0,0 +1,6 @@
1
+ source 'https://rubygems.org'
2
+
3
+ # Specify your gem's dependencies in resource_subscriber.gemspec
4
+ gemspec
5
+
6
+ gem 'action_subscriber', :github => 'jasonayre/action_subscriber'
data/LICENSE.txt ADDED
@@ -0,0 +1,21 @@
1
+ The MIT License (MIT)
2
+
3
+ Copyright (c) 2016 Jason Ayre
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in
13
+ all copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
21
+ THE SOFTWARE.
data/README.md ADDED
@@ -0,0 +1,95 @@
1
+ # ResourceSubscriber
2
+
3
+ Publish/Subscribe to ActiveRecord model events via ActionSubscriber, work with them in model form.
4
+
5
+ ## Installation
6
+
7
+ Add this line to your application's Gemfile:
8
+
9
+ ```ruby
10
+ gem 'resource_subscriber'
11
+ ```
12
+
13
+ And then execute:
14
+
15
+ $ bundle
16
+
17
+ Or install it yourself as:
18
+
19
+ $ gem install resource_subscriber
20
+
21
+ ## Usage
22
+
23
+ ### Setting Up Routes
24
+ ``` ruby
25
+ ::ActionSubscriber.draw_routes do
26
+ [ :created, :updated, :destroyed ].each do |action|
27
+ route ::DataWarehouse::PurchasesSubscriber, action, :stack => :resourceful, :exchange => :events
28
+ end
29
+ end
30
+ ```
31
+
32
+ ### Publishing Model Changes
33
+ ``` ruby
34
+ module Ecommerce
35
+ class Purchase < ::ActiveRecord::Base
36
+ include ::ResourceSubscriber::Publishable
37
+ resource_publisher.publish_as 'ecommerce/purchases'
38
+ #can also specify exchange
39
+ #resource_publisher.publish_as 'blog/posts', :exchange => 'events'
40
+ end
41
+ end
42
+ ```
43
+
44
+ ### Setting Up Subscriber
45
+ ``` ruby
46
+ module DataWarehouse
47
+ class PurchasesSubscriber < ::ActionSubscriber::Base
48
+ include ::ResourceSubscriber::Resourceful
49
+
50
+ def created
51
+ record_sale
52
+ end
53
+
54
+ def updated
55
+ record_reversal if was_chaged_back? || was_returned?
56
+ end
57
+
58
+ def destroyed
59
+ record_reversal if was_chaged_back? || was_returned?
60
+ end
61
+
62
+ private
63
+ def was_charged_back?
64
+ was_changed?(:status, :from => :processed, :to => :charged_back)
65
+ end
66
+
67
+ def was_returned?
68
+ was_changed?(:status, :from => :processed, :to => :returned)
69
+ end
70
+
71
+ def record_reversal
72
+ #do whatever
73
+ end
74
+
75
+ def record_sale
76
+ #store purchase in a data warehouse table
77
+ end
78
+ end
79
+ end
80
+ ```
81
+
82
+ ## Development
83
+
84
+ After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
85
+
86
+ To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
87
+
88
+ ## Contributing
89
+
90
+ Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/resource_subscriber.
91
+
92
+
93
+ ## License
94
+
95
+ The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
data/Rakefile ADDED
@@ -0,0 +1,6 @@
1
+ require "bundler/gem_tasks"
2
+ require "rspec/core/rake_task"
3
+
4
+ RSpec::Core::RakeTask.new(:spec)
5
+
6
+ task :default => :spec
data/bin/console ADDED
@@ -0,0 +1,14 @@
1
+ #!/usr/bin/env ruby
2
+
3
+ require "bundler/setup"
4
+ require "resource_subscriber"
5
+
6
+ # You can add fixtures and/or initialization code here to make experimenting
7
+ # with your gem easier. You can also use a different console, if you like.
8
+
9
+ # (If you use this, don't forget to add pry to your Gemfile!)
10
+ # require "pry"
11
+ # Pry.start
12
+
13
+ require "irb"
14
+ IRB.start
data/bin/setup ADDED
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env bash
2
+ set -euo pipefail
3
+ IFS=$'\n\t'
4
+ set -vx
5
+
6
+ bundle install
7
+
8
+ # Do any other automated setup that you need to do here
@@ -0,0 +1,30 @@
1
+ module ResourceSubscriber
2
+ module AutoInject
3
+ extend ::ActiveSupport::Concern
4
+
5
+ included do
6
+ class_attribute :_required_dependencies
7
+ self._required_dependencies = ::Set.new
8
+ end
9
+
10
+ def initialize(**options)
11
+ self.class.ensure_required_dependencies(**options)
12
+
13
+ options.each_pair do |k,v|
14
+ instance_variable_set(:"@#{k}", v)
15
+ end
16
+ end
17
+
18
+ module ClassMethods
19
+ def required_dependencies(*args)
20
+ self._required_dependencies = self._required_dependencies + args
21
+ self.__send__(:attr_accessor, *args)
22
+ end
23
+
24
+ def ensure_required_dependencies(**options)
25
+ _missing_dependencies = _required_dependencies.select{ |dep| !options.key?(dep) }
26
+ raise ::StandardError.new("Missing Required Dependencies #{_missing_dependencies.join(',')}", _missing_dependencies) if _missing_dependencies.any?
27
+ end
28
+ end
29
+ end
30
+ end
@@ -0,0 +1,21 @@
1
+ module ResourceSubscriber
2
+ class Changes < SimpleDelegator
3
+ def initialize(changes)
4
+ @changes = changes.with_indifferent_access
5
+ end
6
+
7
+ def __getobj__
8
+ @changes
9
+ end
10
+
11
+ def was_changed?(attribute_name, to:nil, from:nil)
12
+ result = true
13
+ value = self[attribute_name]
14
+ result &&= !!value
15
+ result &&= self.key?(attribute_name)
16
+ result &&= (to == self[attribute_name][1]) if to
17
+ result &&= (from == self[attribute_name][0]) if from
18
+ result
19
+ end
20
+ end
21
+ end
@@ -0,0 +1,7 @@
1
+ module ResourceSubscriber
2
+ class Message < ::Trax::Core::Types::Struct
3
+ string :resource_type
4
+ json :resource
5
+ json :changes
6
+ end
7
+ end
@@ -0,0 +1,14 @@
1
+ module ResourceSubscriber
2
+ module Middlewares
3
+ class HasChanges
4
+ def initialize(app)
5
+ @app = app
6
+ end
7
+
8
+ def call(env)
9
+ env["changes"] = ::ResourceSubscriber::Changes.new(env["payload"]["changes"])
10
+ @app.call(env)
11
+ end
12
+ end
13
+ end
14
+ end
@@ -0,0 +1,16 @@
1
+ module ResourceSubscriber
2
+ module Middlewares
3
+ class Resourceful
4
+ def initialize(app)
5
+ @app = app
6
+ end
7
+
8
+ def call(env)
9
+ attributes = env["payload"]["resource"]
10
+ model = env["payload"]["resource_type"].constantize
11
+ env["resource"] = model.find(attributes["id"])
12
+ @app.call(env)
13
+ end
14
+ end
15
+ end
16
+ end
@@ -0,0 +1,8 @@
1
+ module ResourceSubscriber
2
+ module Middlewares
3
+ extend ::ActiveSupport::Autoload
4
+
5
+ autoload :HasChanges
6
+ autoload :Resourceful
7
+ end
8
+ end
@@ -0,0 +1,33 @@
1
+ module ResourceSubscriber
2
+ module Publishable
3
+ extend ::ActiveSupport::Concern
4
+
5
+ included do
6
+ after_commit :publish_created, :on => :create
7
+ after_commit :publish_updated, :on => :update
8
+ after_commit :publish_destroyed, :on => :destroy
9
+
10
+ self.class_attribute :resource_publisher
11
+ self.resource_publisher = ::ResourceSubscriber::Publisher.new(model: self, config: ::ResourceSubscriber::PublisherConfig.new)
12
+ end
13
+
14
+ module ClassMethods
15
+ def publish_to(routing_key, exchange:'events')
16
+ self.resource_publisher.config.exchange = exchange
17
+ self.resource_publisher.config.routing_key = routing_key
18
+ end
19
+ end
20
+
21
+ def publish_created
22
+ self.resource_publisher.publish_resource_message('created', self)
23
+ end
24
+
25
+ def publish_destroyed
26
+ self.resource_publisher.publish_resource_message('destroyed', self)
27
+ end
28
+
29
+ def publish_updated
30
+ self.resource_publisher.publish_resource_message('updated', self)
31
+ end
32
+ end
33
+ end
@@ -0,0 +1,26 @@
1
+ module ResourceSubscriber
2
+ class Publisher
3
+ include ::ResourceSubscriber::AutoInject
4
+
5
+ required_dependencies :model, :config
6
+
7
+ def resource_base_class_name
8
+ @resource_base_class_name ||= model.base_class.name
9
+ end
10
+
11
+ def publish_resource_message(action, resource)
12
+ message = ::ResourceSubscriber::Message.new(
13
+ :resource => resource.attributes,
14
+ :resource_type => resource_base_class_name,
15
+ :changes => resource.previous_changes
16
+ ).to_json
17
+
18
+ ::ActionSubscriber::Publisher.publish_async("#{self.config.routing_key}.#{action}", message, self.config.exchange, :content_type => 'application/json')
19
+ end
20
+
21
+ def publish_as(routing_key, exchange:'events')
22
+ self.config[:exchange] = exchange
23
+ self.config[:routing_key] = routing_key
24
+ end
25
+ end
26
+ end
@@ -0,0 +1,6 @@
1
+ module ResourceSubscriber
2
+ class PublisherConfig < ::Trax::Core::Types::Struct
3
+ string :exchange, :default => "events"
4
+ string :routing_key, :default => ""
5
+ end
6
+ end
@@ -0,0 +1,13 @@
1
+ module ResourceSubscriber
2
+ class Railtie < ::Rails::Railtie
3
+ ::ActiveSupport.on_load(:action_subscriber_routes) do
4
+ stack :resourceful do
5
+ use ::ResourceSubscriber::Middlewares::HasChanges
6
+ use ::ResourceSubscriber::Middlewares::Resourceful
7
+
8
+ ::ActiveSupport.run_load_hooks(:resource_subscriber_resourceful_stack, self)
9
+ self
10
+ end
11
+ end
12
+ end
13
+ end
@@ -0,0 +1,18 @@
1
+ module ResourceSubscriber
2
+ module Resourceful
3
+ extend ::ActiveSupport::Concern
4
+
5
+ attr_accessor :resource, :changes
6
+
7
+ def initialize(*args)
8
+ super(*args)
9
+
10
+ @resource = env["resource"]
11
+ @changes = env["changes"]
12
+ end
13
+
14
+ def was_changed?(*args, **options)
15
+ @changes.was_changed?(*args, **options)
16
+ end
17
+ end
18
+ end
@@ -0,0 +1,3 @@
1
+ module ResourceSubscriber
2
+ VERSION = "0.1.0"
3
+ end
@@ -0,0 +1,24 @@
1
+ require "resource_subscriber/version"
2
+ require 'active_support/all'
3
+ require 'action_subscriber'
4
+ require 'trax_core'
5
+
6
+ module ResourceSubscriber
7
+ extend ::ActiveSupport::Autoload
8
+
9
+ autoload :AutoInject
10
+ autoload :Changes
11
+ autoload :Message
12
+ autoload :Middlewares
13
+ autoload :Railtie
14
+ autoload :Resourceful
15
+ autoload :Publishable
16
+ autoload :Publisher
17
+ autoload :PublisherConfig
18
+
19
+ def self.load_railtie
20
+ ::ResourceSubscriber::Railtie
21
+ end
22
+
23
+ load_railtie if defined?(Rails)
24
+ end
@@ -0,0 +1,29 @@
1
+ # coding: utf-8
2
+ lib = File.expand_path('../lib', __FILE__)
3
+ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
4
+ require 'resource_subscriber/version'
5
+
6
+ Gem::Specification.new do |spec|
7
+ spec.name = "resource_subscriber"
8
+ spec.version = ResourceSubscriber::VERSION
9
+ spec.authors = ["Jason Ayre"]
10
+ spec.email = ["jasonayre@gmail.com"]
11
+
12
+ spec.summary = %q{Resourceful enhancements for action_subscriber}
13
+ spec.description = %q{Resourceful enhancements for action_subscriber}
14
+ spec.homepage = "https://github.com/jasonayre/resource_subscriber"
15
+ spec.license = "MIT"
16
+
17
+ spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
18
+ spec.bindir = "exe"
19
+ spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
20
+ spec.require_paths = ["lib"]
21
+
22
+ spec.add_dependency "activesupport"
23
+ spec.add_dependency "action_subscriber"
24
+ spec.add_dependency "trax_core"
25
+
26
+ spec.add_development_dependency "bundler", "~> 1.11"
27
+ spec.add_development_dependency "rake", "~> 10.0"
28
+ spec.add_development_dependency "rspec", "~> 3.0"
29
+ end
metadata ADDED
@@ -0,0 +1,151 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: resource_subscriber
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - Jason Ayre
8
+ autorequire:
9
+ bindir: exe
10
+ cert_chain: []
11
+ date: 2016-05-17 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: activesupport
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - ">="
18
+ - !ruby/object:Gem::Version
19
+ version: '0'
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - ">="
25
+ - !ruby/object:Gem::Version
26
+ version: '0'
27
+ - !ruby/object:Gem::Dependency
28
+ name: action_subscriber
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - ">="
32
+ - !ruby/object:Gem::Version
33
+ version: '0'
34
+ type: :runtime
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - ">="
39
+ - !ruby/object:Gem::Version
40
+ version: '0'
41
+ - !ruby/object:Gem::Dependency
42
+ name: trax_core
43
+ requirement: !ruby/object:Gem::Requirement
44
+ requirements:
45
+ - - ">="
46
+ - !ruby/object:Gem::Version
47
+ version: '0'
48
+ type: :runtime
49
+ prerelease: false
50
+ version_requirements: !ruby/object:Gem::Requirement
51
+ requirements:
52
+ - - ">="
53
+ - !ruby/object:Gem::Version
54
+ version: '0'
55
+ - !ruby/object:Gem::Dependency
56
+ name: bundler
57
+ requirement: !ruby/object:Gem::Requirement
58
+ requirements:
59
+ - - "~>"
60
+ - !ruby/object:Gem::Version
61
+ version: '1.11'
62
+ type: :development
63
+ prerelease: false
64
+ version_requirements: !ruby/object:Gem::Requirement
65
+ requirements:
66
+ - - "~>"
67
+ - !ruby/object:Gem::Version
68
+ version: '1.11'
69
+ - !ruby/object:Gem::Dependency
70
+ name: rake
71
+ requirement: !ruby/object:Gem::Requirement
72
+ requirements:
73
+ - - "~>"
74
+ - !ruby/object:Gem::Version
75
+ version: '10.0'
76
+ type: :development
77
+ prerelease: false
78
+ version_requirements: !ruby/object:Gem::Requirement
79
+ requirements:
80
+ - - "~>"
81
+ - !ruby/object:Gem::Version
82
+ version: '10.0'
83
+ - !ruby/object:Gem::Dependency
84
+ name: rspec
85
+ requirement: !ruby/object:Gem::Requirement
86
+ requirements:
87
+ - - "~>"
88
+ - !ruby/object:Gem::Version
89
+ version: '3.0'
90
+ type: :development
91
+ prerelease: false
92
+ version_requirements: !ruby/object:Gem::Requirement
93
+ requirements:
94
+ - - "~>"
95
+ - !ruby/object:Gem::Version
96
+ version: '3.0'
97
+ description: Resourceful enhancements for action_subscriber
98
+ email:
99
+ - jasonayre@gmail.com
100
+ executables: []
101
+ extensions: []
102
+ extra_rdoc_files: []
103
+ files:
104
+ - ".gitignore"
105
+ - ".rspec"
106
+ - ".travis.yml"
107
+ - Gemfile
108
+ - LICENSE.txt
109
+ - README.md
110
+ - Rakefile
111
+ - bin/console
112
+ - bin/setup
113
+ - lib/resource_subscriber.rb
114
+ - lib/resource_subscriber/auto_inject.rb
115
+ - lib/resource_subscriber/changes.rb
116
+ - lib/resource_subscriber/message.rb
117
+ - lib/resource_subscriber/middlewares.rb
118
+ - lib/resource_subscriber/middlewares/has_changes.rb
119
+ - lib/resource_subscriber/middlewares/resourceful.rb
120
+ - lib/resource_subscriber/publishable.rb
121
+ - lib/resource_subscriber/publisher.rb
122
+ - lib/resource_subscriber/publisher_config.rb
123
+ - lib/resource_subscriber/railtie.rb
124
+ - lib/resource_subscriber/resourceful.rb
125
+ - lib/resource_subscriber/version.rb
126
+ - resource_subscriber.gemspec
127
+ homepage: https://github.com/jasonayre/resource_subscriber
128
+ licenses:
129
+ - MIT
130
+ metadata: {}
131
+ post_install_message:
132
+ rdoc_options: []
133
+ require_paths:
134
+ - lib
135
+ required_ruby_version: !ruby/object:Gem::Requirement
136
+ requirements:
137
+ - - ">="
138
+ - !ruby/object:Gem::Version
139
+ version: '0'
140
+ required_rubygems_version: !ruby/object:Gem::Requirement
141
+ requirements:
142
+ - - ">="
143
+ - !ruby/object:Gem::Version
144
+ version: '0'
145
+ requirements: []
146
+ rubyforge_project:
147
+ rubygems_version: 2.5.1
148
+ signing_key:
149
+ specification_version: 4
150
+ summary: Resourceful enhancements for action_subscriber
151
+ test_files: []