action_cable_notifications 0.1.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.
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: 3208ee7a8df2cd087f3ef9067fca4da783ef9afe
4
+ data.tar.gz: 15d6a3138c7d6aa2b4b2cebdd1b54673ac51616c
5
+ SHA512:
6
+ metadata.gz: 2ecb8ca921ea58baddd3452a51aa3243fdfb8c20ecf3760f5a9c003ab9f782bf335240d0c89a464894e0f540f83b89eaeedd91a848065167ede83acbdd0cfdda
7
+ data.tar.gz: a02c1d61f271a7f1402f21e24bd8ac45893df76ca944d17ef4ca733b22ab0ce944a1ea652e9569691450d9b02d6d370259ee15fd13ee7eb45a89286312c1aaa8
data/MIT-LICENSE ADDED
@@ -0,0 +1,20 @@
1
+ Copyright 2016 Guillermo Bisheimer
2
+
3
+ Permission is hereby granted, free of charge, to any person obtaining
4
+ a copy of this software and associated documentation files (the
5
+ "Software"), to deal in the Software without restriction, including
6
+ without limitation the rights to use, copy, modify, merge, publish,
7
+ distribute, sublicense, and/or sell copies of the Software, and to
8
+ permit persons to whom the Software is furnished to do so, subject to
9
+ the following conditions:
10
+
11
+ The above copyright notice and this permission notice shall be
12
+ included in all copies or substantial portions of the Software.
13
+
14
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
17
+ NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
18
+ LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
19
+ OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
data/README.md ADDED
@@ -0,0 +1,47 @@
1
+ # ActionCableNotifications
2
+ Short description and motivation.
3
+
4
+ ## Usage
5
+ How to use my plugin.
6
+
7
+ ## Installation
8
+ Add this line to your application's Gemfile:
9
+
10
+ ```ruby
11
+ gem 'action_cable_notifications'
12
+ ```
13
+
14
+ And then execute:
15
+ ```bash
16
+ $ bundle
17
+ ```
18
+
19
+ Or install it yourself as:
20
+ ```bash
21
+ $ gem install action_cable_notifications
22
+ ```
23
+
24
+ ## Usage
25
+ Create a new channel (`rails g cahnnel Test`) or modify existing one including `ActionCableNotifications::Streams` module.
26
+
27
+ ```ruby
28
+ class TestChannel < ApplicationCable::Channel
29
+
30
+ include ActionCableNotifications::Streams
31
+
32
+ def subscribed
33
+ stream_for model, include_initial: true
34
+ end
35
+
36
+ def unsubscribed
37
+ # Any cleanup needed when channel is unsubscribed
38
+ end
39
+ end
40
+ ```
41
+
42
+ ## Contributing
43
+ Contribution directions go here.
44
+
45
+ ## License
46
+ The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
47
+
data/Rakefile ADDED
@@ -0,0 +1,37 @@
1
+ begin
2
+ require 'bundler/setup'
3
+ rescue LoadError
4
+ puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
5
+ end
6
+
7
+ require 'rdoc/task'
8
+
9
+ RDoc::Task.new(:rdoc) do |rdoc|
10
+ rdoc.rdoc_dir = 'rdoc'
11
+ rdoc.title = 'ActionCableNotifications'
12
+ rdoc.options << '--line-numbers'
13
+ rdoc.rdoc_files.include('README.md')
14
+ rdoc.rdoc_files.include('lib/**/*.rb')
15
+ end
16
+
17
+ APP_RAKEFILE = File.expand_path("../test/dummy/Rakefile", __FILE__)
18
+ load 'rails/tasks/engine.rake'
19
+
20
+
21
+ load 'rails/tasks/statistics.rake'
22
+
23
+
24
+
25
+ require 'bundler/gem_tasks'
26
+
27
+ require 'rake/testtask'
28
+
29
+ Rake::TestTask.new(:test) do |t|
30
+ t.libs << 'lib'
31
+ t.libs << 'test'
32
+ t.pattern = 'test/**/*_test.rb'
33
+ t.verbose = false
34
+ end
35
+
36
+
37
+ task default: :test
@@ -0,0 +1,2 @@
1
+ //= link_directory ../javascripts/action_cable_notifications .js
2
+ //= link_directory ../stylesheets/action_cable_notifications .css
@@ -0,0 +1,13 @@
1
+ // This is a manifest file that'll be compiled into application.js, which will include all the files
2
+ // listed below.
3
+ //
4
+ // Any JavaScript/Coffee file within this directory, lib/assets/javascripts, vendor/assets/javascripts,
5
+ // or any plugin's vendor/assets/javascripts directory can be referenced here using a relative path.
6
+ //
7
+ // It's not advisable to add code directly here, but if you do, it'll appear at the bottom of the
8
+ // compiled file. JavaScript code in this file should be added after the last require_* statement.
9
+ //
10
+ // Read Sprockets README (https://github.com/rails/sprockets#sprockets-directives) for details
11
+ // about supported directives.
12
+ //
13
+ //= require_tree .
@@ -0,0 +1,15 @@
1
+ /*
2
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
3
+ * listed below.
4
+ *
5
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
6
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
7
+ *
8
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
9
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
10
+ * files in this directory. Styles in this file should be added after the last require_* statement.
11
+ * It is generally better to create a new file per style scope.
12
+ *
13
+ *= require_tree .
14
+ *= require_self
15
+ */
@@ -0,0 +1,5 @@
1
+ module ActionCableNotifications
2
+ class ApplicationController < ActionController::Base
3
+ protect_from_forgery with: :exception
4
+ end
5
+ end
@@ -0,0 +1,4 @@
1
+ module ActionCableNotifications
2
+ module ApplicationHelper
3
+ end
4
+ end
@@ -0,0 +1,4 @@
1
+ module ActionCableNotifications
2
+ class ApplicationJob < ActiveJob::Base
3
+ end
4
+ end
@@ -0,0 +1,6 @@
1
+ module ActionCableNotifications
2
+ class ApplicationMailer < ActionMailer::Base
3
+ default from: 'from@example.com'
4
+ layout 'mailer'
5
+ end
6
+ end
@@ -0,0 +1,5 @@
1
+ module ActionCableNotifications
2
+ class ApplicationRecord < ActiveRecord::Base
3
+ self.abstract_class = true
4
+ end
5
+ end
@@ -0,0 +1,14 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <title>Action cable notifications</title>
5
+ <%= stylesheet_link_tag "action_cable_notifications/application", media: "all" %>
6
+ <%= javascript_include_tag "action_cable_notifications/application" %>
7
+ <%= csrf_meta_tags %>
8
+ </head>
9
+ <body>
10
+
11
+ <%= yield %>
12
+
13
+ </body>
14
+ </html>
data/config/routes.rb ADDED
@@ -0,0 +1,2 @@
1
+ ActionCableNotifications::Engine.routes.draw do
2
+ end
@@ -0,0 +1,5 @@
1
+ require "action_cable_notifications/engine"
2
+
3
+ module ActionCableNotifications
4
+ # Your code goes here...
5
+ end
@@ -0,0 +1,50 @@
1
+ module ActionCableNotifications
2
+ module Callbacks
3
+ extend ActiveSupport::Concern
4
+
5
+ included do
6
+ after_update :notify_update
7
+ after_create :notify_create
8
+ after_destroy :notify_destroy
9
+ end
10
+
11
+ module ClassMethods
12
+ def notify_initial( collection=nil )
13
+ collection ||= self
14
+ data = {
15
+ collection: self.model_name.collection,
16
+ msg: 'add',
17
+ data: collection.all
18
+ }
19
+ end
20
+ end
21
+
22
+ def notify_create
23
+ ActionCable.server.broadcast self.model_name.collection,
24
+ collection: self.model_name.collection,
25
+ msg: 'create',
26
+ id: self.id,
27
+ fields: self
28
+ end
29
+
30
+ def notify_update
31
+ changes = {}
32
+ self.changes.each do |k,v|
33
+ changes[k] = v[1]
34
+ end
35
+
36
+ ActionCable.server.broadcast self.model_name.collection,
37
+ collection: self.model_name.collection,
38
+ msg: 'update',
39
+ id: self.id,
40
+ fields: changes
41
+ end
42
+
43
+ def notify_destroy
44
+ ActionCable.server.broadcast self.model_name.collection,
45
+ collection: self.model_name.collection,
46
+ msg: 'destroy',
47
+ id: self.id
48
+ end
49
+ end
50
+ end
@@ -0,0 +1,8 @@
1
+ require 'action_cable_notifications/callbacks.rb'
2
+ require 'action_cable_notifications/streams.rb'
3
+
4
+ module ActionCableNotifications
5
+ class Engine < ::Rails::Engine
6
+ isolate_namespace ActionCableNotifications
7
+ end
8
+ end
@@ -0,0 +1,34 @@
1
+ module ActionCableNotifications
2
+ module Streams
3
+ extend ActiveSupport::Concern
4
+
5
+ included do
6
+ class_attribute :ActionCableNotificationsOptions
7
+ self.ActionCableNotificationsOptions = {}
8
+ end
9
+
10
+ private
11
+
12
+ def stream_for(model, options = {})
13
+
14
+ # Original behaviour
15
+ if options.is_a? Proc
16
+ super(model, options)
17
+ else
18
+
19
+ # Checks if model already includes notification callbacks
20
+ if !model.respond_to? :notify_initial
21
+ model.send('include', ActionCableNotifications::Callbacks)
22
+ end
23
+
24
+ super(model, options[:callback])
25
+
26
+ # Transmit initial state if required
27
+ if options[:include_initial].present?
28
+ transmit model.notify_initial
29
+ end
30
+ end
31
+ end
32
+
33
+ end
34
+ end
@@ -0,0 +1,3 @@
1
+ module ActionCableNotifications
2
+ VERSION = '0.1.2'
3
+ end
@@ -0,0 +1,4 @@
1
+ # desc "Explaining what the task does"
2
+ # task :action_cable_notifications do
3
+ # # Task goes here
4
+ # end
metadata ADDED
@@ -0,0 +1,99 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: action_cable_notifications
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.2
5
+ platform: ruby
6
+ authors:
7
+ - ByS Sistemas de Control
8
+ autorequire:
9
+ bindir: bin
10
+ cert_chain: []
11
+ date: 2016-08-29 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: rails
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - "~>"
18
+ - !ruby/object:Gem::Version
19
+ version: 5.0.0
20
+ - - ">="
21
+ - !ruby/object:Gem::Version
22
+ version: 5.0.0.1
23
+ type: :runtime
24
+ prerelease: false
25
+ version_requirements: !ruby/object:Gem::Requirement
26
+ requirements:
27
+ - - "~>"
28
+ - !ruby/object:Gem::Version
29
+ version: 5.0.0
30
+ - - ">="
31
+ - !ruby/object:Gem::Version
32
+ version: 5.0.0.1
33
+ - !ruby/object:Gem::Dependency
34
+ name: sqlite3
35
+ requirement: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - ">="
38
+ - !ruby/object:Gem::Version
39
+ version: '0'
40
+ type: :development
41
+ prerelease: false
42
+ version_requirements: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - ">="
45
+ - !ruby/object:Gem::Version
46
+ version: '0'
47
+ description: Rails engine that provides automatic notification broadcasts for Ruby
48
+ on Rails models changes using Action Cable and websockets
49
+ email:
50
+ - info@bys-control.com.ar
51
+ executables: []
52
+ extensions: []
53
+ extra_rdoc_files: []
54
+ files:
55
+ - MIT-LICENSE
56
+ - README.md
57
+ - Rakefile
58
+ - app/assets/config/action_cable_notifications_manifest.js
59
+ - app/assets/javascripts/action_cable_notifications/application.js
60
+ - app/assets/stylesheets/action_cable_notifications/application.css
61
+ - app/controllers/action_cable_notifications/application_controller.rb
62
+ - app/helpers/action_cable_notifications/application_helper.rb
63
+ - app/jobs/action_cable_notifications/application_job.rb
64
+ - app/mailers/action_cable_notifications/application_mailer.rb
65
+ - app/models/action_cable_notifications/application_record.rb
66
+ - app/views/layouts/action_cable_notifications/application.html.erb
67
+ - config/routes.rb
68
+ - lib/action_cable_notifications.rb
69
+ - lib/action_cable_notifications/callbacks.rb
70
+ - lib/action_cable_notifications/engine.rb
71
+ - lib/action_cable_notifications/streams.rb
72
+ - lib/action_cable_notifications/version.rb
73
+ - lib/tasks/action_cable_notifications_tasks.rake
74
+ homepage: https://github.com/bys-control/action_cable_notifications
75
+ licenses:
76
+ - MIT
77
+ metadata: {}
78
+ post_install_message:
79
+ rdoc_options: []
80
+ require_paths:
81
+ - lib
82
+ required_ruby_version: !ruby/object:Gem::Requirement
83
+ requirements:
84
+ - - ">="
85
+ - !ruby/object:Gem::Version
86
+ version: '0'
87
+ required_rubygems_version: !ruby/object:Gem::Requirement
88
+ requirements:
89
+ - - ">="
90
+ - !ruby/object:Gem::Version
91
+ version: '0'
92
+ requirements: []
93
+ rubyforge_project:
94
+ rubygems_version: 2.5.1
95
+ signing_key:
96
+ specification_version: 4
97
+ summary: Realtime notification broadcast for Ruby on Rails models changes using Action
98
+ Cable and websockets
99
+ test_files: []