power-emitter 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e8522337dac72f802f063d9fff0f26fe7b9f99448a8b1595b97347f717fda5cf
+  data.tar.gz: e50ccf9bec65f4dfbc7c8d796627f9cd88b679355394b9840ee2292e122cddaf
+SHA512:
+  metadata.gz: 022a760a03b8c46b3ecd31fafe98e945f9b3aa91fdd2c09ce0e167fa56a459ad23a8f2fbe0776b40b933763aae2cd7d0ebc1a645d22e64a8b49a96c85eb8a95b
+  data.tar.gz: 6493245c97280ddac913ad5e4264c6d046c98da7d5b84b490fe2cc98cb8230e43a2a060d0a366cf5bea6f08932721b6a28577831772a8488b1d61afc0f288a01

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Max Power
+
+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,75 @@
+# Power::Emitter
+
+# Emitter
+
+A lightweight Ruby event emitter that allows you to bind, emit, and stop custom events using blocks.
+
+## Features
+
+- Bind callbacks to custom event names
+- Emit events with arguments
+- Stop listening to specific or all events
+
+## API
+
+`bind(event, &block)`
+Registers a block (callback) to an event.
+
+`emit(event, *args)`
+Calls all callbacks for the given event, passing in arguments.
+
+`stop(*events)`
+- If called with arguments, stops those specific events.
+- If called without arguments, clears all listeners.
+
+## Usage
+```ruby
+emitter = Emittable::Emitter.new
+
+# Bind a listener
+emitter.bind(:greet) { |name| puts "Hello, #{name}!" }
+
+# Emit an event
+emitter.emit(:greet, "World")  # => prints "Hello, World!"
+
+# Stop a specific event
+emitter.stop(:greet)
+
+# Stop all events
+emitter.stop
+```
+
+
+## Example with Emittable
+
+```ruby
+class Chat
+  include Emittable
+  #include Emittable::Aliases
+
+  def initialize
+    @messages = []
+  end
+
+  def add_message(msg)
+    emit :new_message, msg
+    @messages << msg
+  end
+
+  def clear!
+    emit :clear_messages, @messages
+    @messages.clear
+  end
+end
+
+chat = Chat.new
+chat.bind(:new_message) { |msg| puts "New Message: #{msg}" }
+chat.bind(:clear_messages) { |msgs| puts "#{msgs.count} Messages deleted!" }
+```
+
+The Chat class includes Emittable, a mixin that adds event-driven capabilities by creating a private emitter instance method.
+Internally, it uses Ruby’s Forwardable module to delegate bind, emit, and stop calls directly to the underlying Emitter instance.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "tldr/rake"
+
+task default: :tldr

data/lib/emitter.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+module Emittable
+  require "forwardable"
+  extend Forwardable
+
+  def_delegators :emitter, :bind, :emit, :stop
+
+  private
+
+  def emitter
+    @emitter ||= Emittable::Emitter.new
+  end
+
+  class Emitter
+    def initialize
+      @listeners = Hash.new { |h,k| h[k] = [] }
+    end
+
+    def bind(event, &block)
+      @listeners[event] << block
+    end
+
+    def emit(event, *args)
+      @listeners[event].map { it.call(*args) }
+    end
+
+    def stop(*events)
+      return @listeners.clear if events.empty?
+      events.each { @listeners.delete it }
+    end
+  end
+
+  module Aliases
+    BIND = %i[ on subscribe listen observe handle ].freeze
+    EMIT = %i[ fire publish broadcast notify trigger ].freeze
+    STOP = %i[ off unsubscribe drop ignore release ].freeze
+
+    def self.included(base)
+      BIND.each { base.alias_method it, :bind }
+      EMIT.each { base.alias_method it, :emit }
+      STOP.each { base.alias_method it, :stop }
+    end
+  end
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification
+name: power-emitter
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Max Power
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+email:
+- kevin.melchert@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/emitter.rb
+homepage: https://github.com/max-power/power-emitter/
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.5
+specification_version: 4
+summary: A lightweight Ruby event emitter that allows you to bind, emit, and stop
+  custom events using blocks.
+test_files: []