hey_you 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0c018de345da36b48230e5112994e6a66ecb5989
+  data.tar.gz: 70d3e962be350ce484ecf3a72b4ce997c645a0c6
+SHA512:
+  metadata.gz: 6b03ee0fa70c91c3b232149355e67ea56cc8088cee65592be75ed7016b242d56284a6d41dd1e4ffb97aac750b7c839dff0b796b890b0e1a386bbe7d2a44f284f
+  data.tar.gz: e23934a28526f206e72c0208342e3ad9d46db33058337663814519caaea8fd9a33cdbfe5941a590b9f7a27c4882c6f5f66f463a2d619de084bb919e3370cd514

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+rvm:
+  - 2.2.3
+before_install: gem install bundler -v 1.10.6
+
+before_script:
+  - psql -c 'create database hey_you_test;' -U postgres

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,13 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, ethnicity, age, or religion.
+
+Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
+
+Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
+
+This Code of Conduct is adapted from the [Contributor Covenant](http://contributor-covenant.org), version 1.0.0, available at [http://contributor-covenant.org/version/1/0/0/](http://contributor-covenant.org/version/1/0/0/)

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in hey_you.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 schneems
+
+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,105 @@
+# HeyYou
+
+[![Build Status](https://travis-ci.org/schneems/hey_you.svg?branch=master)](https://travis-ci.org/schneems/hey_you)
+
+Use postgres to [LISTEN/NOTIFY](http://www.postgresql.org/docs/9.1/static/sql-notify.html) to trigger custom events.
+
+## Why?
+
+Let's say you've got a fleet of machines running code, you only want to trigger a custom event on all of them or one of them. With `HeyYou` it is super easy. What kind of event? Maybe it is for debugging or maybe it is for housekeeping. For example you could take a heap dump off of a running server and upload it to S3 using this library.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'hey_you'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install hey_you
+
+## Usage
+
+Somewhere in your code you can run:
+
+```ruby
+HeyYou.new.listen do |payload|
+  puts "Hey I got a message: #{payload}"
+end
+```
+
+This will spin up a new thread and periodically check for a notification, this won't block execution by default.
+
+Then in another console, you can run:
+
+```ruby
+HeyYou.new.notify("sup")
+```
+
+When your listening process gets the message it will print out
+
+```ruby
+"Hey I got a message: sup"
+```
+
+By default all listens and notifies happen on the same channel. If you want you can specify a different channel
+
+```ruby
+HeyYou.new(channel: "new_channel_name").listen do |payload|
+  puts "Hey I got a message: #{payload}"
+end
+```
+
+It is important to note that you need to notify against the same name.
+
+```ruby
+HeyYou.new(channel: "new_channel_name").notify("sup")
+```
+
+By default the background thread wakes up every 60 seconds and waits 0.1 seconds to see if there is a message. You can customize this behavior using `sleep` and `ttl`. So to have it check every 10 seconds, and not wait at all you could run
+
+```ruby
+HeyYou.new(ttl: 1, sleep: 10).listen do |payload|
+  puts "Hey I got a message: #{payload}"
+end
+```
+
+A lower sleep will decrease delay between sending and receiving messages but will decrease overall program performance.
+
+## Connection
+
+By default HeyYou assumes you're using Active Record and already have a connection configured. If you want to use a different ORM, you'll need to provide HeyYou with an object that responds to `exec` that executes arbitrary SQL and a method `wait_for_notify` that accepts `ttl`, `sleep` and takes a block.
+
+You can configure your connection manually
+
+```ruby
+HeyYou.new(connection: my_custom_object)
+```
+
+Or you can set it globally
+
+```ruby
+HeyYou::DEFAULT_CONNECTION = my_custom_object
+```
+
+## Development
+
+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.
+
+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).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/hey_you. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,7 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+task :test    => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "hey_you"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/hey_you.gemspec

@@ -0,0 +1,28 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hey_you/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "hey_you"
+  spec.version       = HeyYou::VERSION
+  spec.authors       = ["schneems"]
+  spec.email         = ["richard.schneeman@gmail.com"]
+
+  spec.summary       = %q{Use postgres to trigger custom events}
+  spec.description   = %q{Trigger custom events with postgres}
+  spec.homepage      = "https://github.com/schneems/hey_you"
+  spec.license       = "MIT"
+
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "pg", ">= 0.15"
+  spec.add_development_dependency "activerecord", ">= 3"
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec"
+end

data/lib/hey_you.rb

@@ -0,0 +1,44 @@
+require "hey_you/version"
+
+class HeyYou
+  DEFAULT_CHANNEL = "hey_you_default_channel"
+  DEFAULT_CONNECTION_CONNECTOR = Proc.new do
+    if defined?(DEFAULT_CONNECTION)
+      DEFAULT_CONNECTION
+    elsif defined?(ActiveRecord::Base)
+      ActiveRecord::Base.connection.raw_connection
+    else
+      false
+    end
+  end
+
+  attr_reader :channel
+  def initialize(ttl: 0.1, sleep: 60, channel: DEFAULT_CHANNEL, connection: DEFAULT_CONNECTION_CONNECTOR.call)
+    raise "The new method does not take a block, perhaps you meant to call the listen method?" if block_given?
+    @ttl     = ttl
+    @sleep   = sleep
+    @channel = channel
+    @raw_connection = connection
+  end
+
+  def listen(&block)
+    raise "No block given" unless block
+    @raw_connection.exec "LISTEN #{channel}"
+
+    @thread = Thread.new do
+      while true do
+        sleep @sleep
+
+        @raw_connection.wait_for_notify(@ttl) do |channel_sent, pid, payload|
+          block.call(payload) if channel_sent == self.channel
+        end
+      end
+    end
+  end
+
+  def notify(payload)
+    message = "NOTIFY #{channel}, '#{payload}'"
+    puts message
+    @raw_connection.exec(message)
+  end
+end

data/lib/hey_you/version.rb

@@ -0,0 +1,3 @@
+class HeyYou
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: hey_you
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- schneems
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2015-11-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.15'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !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'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Trigger custom events with postgres
+email:
+- richard.schneeman@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- hey_you.gemspec
+- lib/hey_you.rb
+- lib/hey_you/version.rb
+homepage: https://github.com/schneems/hey_you
+licenses:
+- MIT
+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.4.5.1
+signing_key: 
+specification_version: 4
+summary: Use postgres to trigger custom events
+test_files: []