direction 0.0.5 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 70ef36550c39745b1259e2f37ce744e0a084ce59
-  data.tar.gz: 923ffca99a808f99a6032a773b0fa8552823e0bc
+SHA256:
+  metadata.gz: 47a9e819539f9cf4a771f373c301a8c87e54aaa187b958d44e862f531a55e760
+  data.tar.gz: 1c7ae5a125f83031c30977f892ba52eeeeec14a7adba1f8d932db051b14b643e
 SHA512:
-  metadata.gz: e1ecae8e58ff1e234052b3768b49b8fe5db442c94efd9e55c6a0eacd80bd51fbd441819516c9daa450eac86b897295ee1b15b07b051034be21aafa727174022d
-  data.tar.gz: 8d18a5b422438f796853401efbbf35dcf8e3ff9289628a0b6b1b71c65cbf2d1b79fa2aa9b29f83882761b7739f5813e74834b9241d4f352f364d796a3cee7f23
+  metadata.gz: 8ea409e148817c51a47e69af81b1cb29ff9fa3a4bca52e441ad81ad5f8390295cd9b76671abd7a4099785e55698f2d0e02219fe30684fe318112604c4035aa36
+  data.tar.gz: a8ea1f8065e5a46e9307cfd1dc971a1cf4fd949bc76896c2f1ea81f9732240f7f106fb7d5389491ac8d4fc99699295447249192ca2ec00e21dbd354c749414f4

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](http://keepachangelog.com/)
+and this project adheres to [Semantic Versioning](http://semver.org/).
+
+## [] - 
+
+### 
+
+- [2.0.0]

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders 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, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+jim@saturnflyer.com.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

data/Gemfile

@@ -1,11 +1,9 @@
-source 'https://rubygems.org'
+source "https://rubygems.org"
 
 gemspec
 
-group :test do
-  gem 'rubinius-coverage', platform: :rbx
-  gem 'coveralls', require: false
-  gem 'minitest'
-  gem 'rake'
-  gem 'simplecov'
-end
+gem "minitest"
+gem "rake"
+gem "reissue"
+gem "simplecov"
+gem "standardrb"

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2014 'Jim Gay'
+Copyright (c) 2014-2025 'Jim Gay'
 
 MIT License
 

data/README.md

@@ -1,8 +1,5 @@
 # Direction
 
-[![Build Status](https://travis-ci.org/saturnflyer/direction.png?branch=master)](https://travis-ci.org/saturnflyer/direction)
-[![Code Climate](https://codeclimate.com/github/saturnflyer/direction.png)](https://codeclimate.com/github/saturnflyer/direction)
-[![Coverage Status](https://coveralls.io/repos/saturnflyer/direction/badge.png)](https://coveralls.io/r/saturnflyer/direction)
 [![Gem Version](https://badge.fury.io/rb/direction.png)](http://badge.fury.io/rb/direction)
 
 Enforce better encapsulation by returning self from commands.
@@ -40,7 +37,6 @@ person.print_address(template) #=> person
 
 This will define methods on instances that forward to the provided receiver while enforcing encapsulation of the relationship between objects.
 
-
 ## Installation
 
 Add this line to your application's Gemfile:

data/Rakefile

@@ -1,12 +1,18 @@
 #!/usr/bin/env rake
 require "bundler/gem_tasks"
-require 'rake/testtask'
+require "rake/testtask"
+require "reissue/gem"
+
+Reissue::Task.create :reissue do |task|
+  task.version_file = "lib/direction/version.rb"
+  task.fragment = :git
+end
 
 Rake::TestTask.new do |t|
-  t.libs << 'test'
-  t.test_files = FileList['test/*_test.rb']
+  t.libs << "test"
+  t.test_files = FileList["test/*_test.rb"]
   t.ruby_opts = ["-w"]
   t.verbose = true
 end
 
-task :default => :test
+task default: :test

data/direction.gemspec

@@ -1,19 +1,28 @@
-# coding: utf-8
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'direction/version'
+require "direction/version"
 
 Gem::Specification.new do |spec|
-  spec.name          = "direction"
-  spec.version       = Direction::VERSION
-  spec.authors       = ["'Jim Gay'"]
-  spec.email         = ["jim@saturnflyer.com"]
-  spec.summary       = %q{Forward messages to collaborators in East-oriented style.}
-  spec.description   = %q{Forward messages to collaborators in East-oriented style.}
-  spec.homepage      = "https://github.com/saturnflyer/direction"
-  spec.license       = "MIT"
+  spec.name = "direction"
+  spec.version = Direction::VERSION
+  spec.authors = ["'Jim Gay'"]
+  spec.email = ["jim@saturnflyer.com"]
+  spec.summary = "Forward messages to collaborators in East-oriented style."
+  spec.description = "Forward messages to collaborators in East-oriented style."
+  spec.homepage = "https://github.com/saturnflyer/direction"
+  spec.license = "MIT"
 
-  spec.files         = [".gitignore", ".travis.yml", "Gemfile", "LICENSE.txt", "README.md", "Rakefile", "direction.gemspec", "lib/direction.rb", "lib/direction/version.rb", "sample.rb", "sample/accountant.rb", "sample/customer.rb", "sample/kitchen.rb", "sample/micro_manager.rb", "sample/server.rb", "test/direction_test.rb", "test/test_helper.rb"]
-  spec.test_files    = ["test/direction_test.rb", "test/test_helper.rb"]
+  spec.files = [
+    "Gemfile",
+    "LICENSE.txt",
+    "README.md",
+    "CODE_OF_CONDUCT.md",
+    "CHANGELOG.md",
+    "Rakefile",
+    "direction.gemspec",
+    "lib/direction.rb",
+    "lib/direction/version.rb"
+  ]
   spec.require_paths = ["lib"]
+  spec.required_ruby_version = ">= 2.7"
 end

data/lib/direction/version.rb

@@ -1,3 +1,3 @@
 module Direction
-  VERSION = "0.0.5"
+  VERSION = "2.0.0"
 end

data/lib/direction.rb

@@ -3,49 +3,44 @@ require "direction/version"
 # but set the return value to self.
 # It provides a class level "command" method to do
 # message forwarding.
-# 
+#
 # class SomeClass
 #   extend Direction
-# 
+#
 #   command [:print_details, :setup_things] => :collaborator
 #   query [:name, :id] => :collaborator, :type => :@partner
+#
+#   def_command :collaborator, :print_details, :aliased_name_for_print_details
 # end
-# 
+#
 # This will define methods on instances that forward to the
-# provided receiver while enforcing encapsulation of the 
+# provided receiver while enforcing encapsulation of the
 # relationship between objects.
 module Direction
+  def self.extended(base)
+    base.extend Forwardable
+  end
 
   # Forward messages and return self, protecting the encapsulation of the object
-  def command(options)
-    Direction.define_methods(self, options) do |command, accessor|
-      %{
-      def #{command}(*args, &block)
-        #{accessor}.__send__(:#{command}, *args, &block)
-        self
-      end
-      }
+  def command(**options)
+    options.each do |methods, accessor|
+      methods.each { |method_name| def_command accessor, method_name }
     end
   end
 
-  # Forward messages and return the result of the forwarded message
-  def query(options)
-    Direction.define_methods(self, options) do |query, accessor|
-      %{
-      def #{query}(*args, &block)
-        #{accessor}.__send__(:#{query}, *args, &block)
-      end
-      }
+  # Create an individual command with an optional alias
+  def def_command accessor, method_name, aliased_method_name = method_name
+    result_name = "#{aliased_method_name}_result"
+    def_delegator accessor, method_name, result_name
+    private result_name
+    define_method aliased_method_name do |*args, **kwargs, &block|
+      send(result_name, *args, **kwargs, &block)
+      self
     end
   end
 
-  def self.define_methods(mod, options)
-    method_defs = []
-    options.each_pair do |method_names, accessor|
-      Array(method_names).map do |message|
-        method_defs.push yield(message, accessor)
-      end
-    end
-    mod.class_eval method_defs.join("\n"), __FILE__, __LINE__
+  # Forward messages and return the result of the forwarded message
+  def query(**options)
+    instance_delegate options
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: direction
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 2.0.0
 platform: ruby
 authors:
 - "'Jim Gay'"
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-12-03 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Forward messages to collaborators in East-oriented style.
 email:
@@ -17,8 +16,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".travis.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -26,19 +25,10 @@ files:
 - direction.gemspec
 - lib/direction.rb
 - lib/direction/version.rb
-- sample.rb
-- sample/accountant.rb
-- sample/customer.rb
-- sample/kitchen.rb
-- sample/micro_manager.rb
-- sample/server.rb
-- test/direction_test.rb
-- test/test_helper.rb
 homepage: https://github.com/saturnflyer/direction
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -46,18 +36,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.2.2
-signing_key: 
+rubygems_version: 3.7.2
 specification_version: 4
 summary: Forward messages to collaborators in East-oriented style.
-test_files:
-- test/direction_test.rb
-- test/test_helper.rb
+test_files: []

data/.gitignore

@@ -1,17 +0,0 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp

data/.travis.yml

@@ -1,11 +0,0 @@
-language: ruby
-rvm:
-  - 2.1.2
-  - ruby-head
-  - jruby-head
-  - rbx-2
-env:
-- COVERALLS=true
-matrix:
-  allow_failures:
-    - rvm: jruby-head

data/sample/accountant.rb

@@ -1,5 +0,0 @@
-class Accountant
-  def accept_funds
-    puts " $$$ Cha-ching!"
-  end
-end

data/sample/customer.rb

@@ -1,9 +0,0 @@
-class Customer
-  extend Direction
-  def initialize(server)
-    @server = server
-  end
-  attr_accessor :server
-  
-  command [:order_food, :pay_bill] => :server
-end

data/sample/kitchen.rb

@@ -1,15 +0,0 @@
-class Kitchen
-  def make_food(food)
-    puts " <Kitchen preparing #{food}>"
-    sleep(3)
-    puts " <Kitchen made #{food}>"
-  end
-  
-  def provide_food(food)
-    puts " <Kitchen served up #{food}>"
-  end
-  
-  def accountant
-    @accountant ||= Accountant.new
-  end
-end

data/sample/micro_manager.rb

@@ -1,6 +0,0 @@
-class MicroManager
-  def initialize(server)
-    @server = server
-  end
-  attr_accessor :server
-end

data/sample/server.rb

@@ -1,34 +0,0 @@
-class Server
-  def initialize(kitchen)
-    @kitchen = kitchen
-    @accountant = kitchen.accountant
-  end
-  attr_reader :kitchen
-  attr_accessor :customer
-  
-  def order_food(food)
-    puts "I'll put that order in for you right now"
-    sleep(2)
-    kitchen.make_food(food)
-    serve_food(food)
-  end
-  
-  def serve_food(food)
-    retrieve_food(food)
-    sleep(2)
-    puts " <Server retrieved #{food}>"
-    return_to_customer(food)
-  end
-  
-  def retrieve_food(food)
-    kitchen.provide_food(food)
-  end
-  
-  def return_to_customer(food)
-    puts "Here's your order of #{food}"
-  end
-  
-  def pay_bill
-    @accountant.accept_funds
-  end
-end

data/sample.rb

@@ -1,27 +0,0 @@
-require 'direction'
-$:.unshift(__dir__) unless $:.include?(__dir__)
-require 'sample/accountant'
-require 'sample/customer'
-require 'sample/kitchen'
-require 'sample/micro_manager'
-require 'sample/server'
-
-def setup
-  @kitchen = Kitchen.new
-  @server = Server.new(@kitchen)
-  @manager = MicroManager.new(@server)
-  @customer = Customer.new(@server)
-  @manager
-  self
-end
-
-def manager
-  @manager
-end
-
-def customer
-  @customer
-end
-
-# Try loading this in the console and interact to make food using @manager vs. @customer
-# customer.order_food('burrito').pay_bill vs. ... lots of commands for @manager

data/test/direction_test.rb

@@ -1,122 +0,0 @@
-require 'test_helper'
-
-class Person
-  extend Direction
-  command [:make_me_a_sandwich, :cook, :blocky] => :@friend
-  query [:activities, :go, :say_what] => :friend
-  attr_accessor :friend
-end
-
-class Friend
-  def make_me_a_sandwich
-    Table.place "a sandwich!"
-  end
-
-  def cook(what)
-    Table.place what
-  end
-
-  def activities
-    'running, biking, hiking'
-  end
-
-  def go(do_what)
-    Activities.record do_what
-  end
-
-  def blocky(text)
-    Activities.record([yield(self).to_s,text].join(' '))
-  end
-
-  def say_what(text)
-    [yield(self).to_s,text].join(' ')
-  end
-end
-
-module Table
-  def self.place(text)
-    contents << text
-  end
-  def self.contents
-    @contents ||= []
-  end
-  def self.clear
-    @contents = []
-  end
-end
-
-module Activities
-  def self.record(text)
-    list << text
-  end
-  def self.list
-    @list ||= []
-  end
-  def self.clear
-    @list = []
-  end
-end
-
-describe Direction, 'command' do
-  let(:friend){ Friend.new }
-  let(:person){ person = Person.new
-                person.friend = friend
-                person
-              }
-  before do
-    Table.clear
-    Activities.clear
-  end
-  it 'forwards a message to another object' do
-    assert_equal [], Table.contents
-    person.make_me_a_sandwich
-    assert_includes Table.contents, "a sandwich!"
-  end
-  
-  it 'returns the original receiver' do
-    assert_equal person, person.make_me_a_sandwich
-  end
-
-  it 'forwards additional arguments' do
-    assert_equal [], Table.contents
-    person.cook('yum')
-    assert_includes Table.contents, "yum"
-  end
-
-  it 'forwards block arguments' do
-    assert_equal [], Activities.list
-    person.blocky('yay!') do |friend|
-      "Arguments forwarded to #{friend}"
-    end
-    assert_includes Activities.list, "Arguments forwarded to #{friend} yay!"
-  end
-end
-
-describe Direction, 'query' do
-  let(:friend){ Friend.new }
-  let(:person){ person = Person.new
-                person.friend = friend
-                person
-              }
-  before do
-    Activities.clear
-  end
-
-  it 'forwards a message to another object' do
-    assert_includes person.activities, "running, biking, hiking"
-  end
-
-  it 'forwards additional arguments' do
-    assert_equal [], Activities.list
-    person.go('have fun')
-    assert_includes Activities.list, "have fun"
-  end
-
-  it 'forwards block arguments' do
-    assert_equal [], Activities.list
-    what_said = person.say_what('yay!') do |friend|
-      "Arguments forwarded to #{friend}"
-    end
-    assert_equal what_said, "Arguments forwarded to #{friend} yay!"
-  end
-end

data/test/test_helper.rb

@@ -1,12 +0,0 @@
-require 'simplecov'
-SimpleCov.start do
-  add_filter 'test'
-end
-
-require 'coveralls'
-if ENV['COVERALLS']
-  Coveralls.wear!
-end
-
-require 'minitest/autorun'
-require 'direction'