traitee 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b069bf35397a5bd4aebf916dc02feeb4b7b3425b
+  data.tar.gz: 7f3f30df241c16e2cd809db9d042e88477f7a78e
+SHA512:
+  metadata.gz: 74f8c42932ad0027f4fe3e698e434d74b358c59cdc742427ac46712f8d8ead8e959d18bd452199ee2ff9ad1edab948423ba8b839f2a23b862f9eed22b3f1daa8
+  data.tar.gz: b6a3e2c8af18e513d38964b14a88597b9914ca887b994f6e4ee3eac2b76e616033bc04feb82f48aecd802caec624c33dc0fcab545874be3d252f4d575fa0a98b

data/README.md

@@ -0,0 +1,49 @@
+# Traitee
+
+Mixins or so-called traits for Ruby (like module does not exist :)).
+
+## How to use Traitee
+```ruby
+require 'traitee'
+
+class Transporter
+  extend(Traitee::Trait)
+
+  serves do
+    def shipping_address
+      'Koniarkova 101, 831 07 Bratislava Slovakia'
+    end
+
+    def current_range
+      kms_left = rand(600) + 10
+      "You have around #{kms_left} kms left."
+    end
+  end
+end
+
+class Shipper
+  extend(Traitee::Trait)
+
+  attr_accessor :width, :height, :depth
+
+  serves do
+    def set_dimensions(w, h, d)
+      @width = w
+      @height = h
+      @depth = d
+    end
+
+    def dimensions
+      "#{@width} x #{@height} x #{@depth}"
+    end
+  end
+end
+
+class Shipment
+  extend Traitee::Merger
+  merge Shipper, Transporter
+end
+
+shipment = Shipment.new
+```
+For more examples take a look into files inside examples folder.

data/lib/traitee.rb

@@ -0,0 +1,6 @@
+require 'traitee/merger'
+require 'traitee/trait'
+require 'traitee/version'
+
+module Traitee
+end

data/lib/traitee/conflict_solver.rb

@@ -0,0 +1,42 @@
+module Traitee
+  class MethodsInConflict < StandardError
+  end
+
+  class ConflictSolver
+    attr_reader :conflicting_methods
+
+    def initialize(methods)
+      @methods = methods
+      @conflicting_methods = {}
+    end
+
+    # java reference :P, actual resolved module holder
+    def this
+      @this ||= Module.new
+    end
+
+    def conflictless_method_map
+      @methods.reduce({}) do |res, map|
+        res.merge!(map) { |method_name, method_a, method_b| solve_possible_conflict(method_name, method_a, method_b) }
+      end
+    end
+
+    # let it build, actual error will be raised later on all the usages of the method
+    def solve_possible_conflict(method_name, method_a, method_b)
+      method_a == method_b ? method_a : method_in_conflict(method_name, method_a, method_b)
+    end
+
+    def method_in_conflict(method_name, method_a, method_b)
+      conflict_solver = self
+      @conflicting_methods[method_name] = [method_a, method_b]
+
+      # define a method which raises an error - uncallable
+      this.send(:define_method, method_name) do
+        _method_a, _method_b = conflict_solver.conflicting_methods[method_name]
+        fail MethodsInConflict.new "Modules  are in conflict with method :#{method_name}"
+      end
+
+      this.instance_method(method_name)
+    end
+  end
+end

data/lib/traitee/dict.rb

@@ -0,0 +1,34 @@
+require 'set'
+
+module Traitee
+  class Dict
+    def initialize
+      @methods = Set.new
+    end
+
+    def <<(method)
+      @methods << method
+    end
+
+    def methods_hash(options = {})
+      except = Array(options[:except])
+      aliases = options.fetch :aliases, {}
+
+      methods_hash = Hash[
+        @methods.map { |method| traitee_module, name = method; [name, traitee_module.instance_method(name)] }
+      ]
+      methods_hash = exclusions(methods_hash, except)
+      aliases(methods_hash, aliases)
+    end
+
+    # fetch only methods on included in except opts
+    def exclusions(methods, exclusions)
+      methods.select { |method_name, _| !exclusions.include?(method_name) }
+    end
+
+    # create aliases for selected methods as described in  opts
+    def aliases(methods, aliases)
+      Hash[methods.map { |method_name, _method| [(aliases.include?(method_name) ? aliases[method_name] : method_name), _method] }]
+    end
+  end
+end

data/lib/traitee/merger.rb

@@ -0,0 +1,16 @@
+require 'traitee/conflict_solver'
+
+module Traitee
+  module Merger
+
+    #just check for conflicts, if there are any, we will raise an Error on call. Dont overwrite owners methods
+    def merge(*maps)
+      maps.map! { |map| Hash === map ? map : map.methods }
+      conflictless_map = ConflictSolver.new(maps).conflictless_method_map
+      conflictless_map.each do |method_name, method|
+        # do not run check for included super methods
+        send(:define_method, method_name, method) unless instance_methods(false).include?(method_name)
+      end
+    end
+  end
+end

data/lib/traitee/trait.rb

@@ -0,0 +1,45 @@
+require 'forwardable'
+require 'traitee/merger'
+require 'traitee/dict'
+
+module Traitee
+  module Trait
+    extend Forwardable # we want some delegators in here, to delegate to the included trait
+    def_instance_delegators :this, :instance_methods, :send
+    alias_method :[], :methods
+
+    include Merger
+
+    def this
+      @this ||= Module.new
+    end
+
+    def dict
+      @dict ||= Dict.new
+    end
+
+    # usable methods
+    def methods(options = {})
+      served_from(this, *this.instance_methods)
+      dict.methods_hash(options)
+    end
+
+    # helper for actual method definitions
+    def serves(&method_def)
+      this.module_eval(&method_def)
+    end
+
+    # store Module where method is defined (trait) and actual method name
+    def served_from(trait_module, *methods)
+      methods.each { |method_name| dict << [trait_module, method_name] }
+    end
+
+    def self.subject_composition(*params, &block)
+      Class.new do
+        extend Trait
+        merge(*params) unless params.empty?
+        serves(&block) if block
+      end
+    end
+  end
+end

data/lib/traitee/version.rb

@@ -0,0 +1,3 @@
+module Traitee
+  VERSION = '0.0.1'
+end

metadata

@@ -0,0 +1,66 @@
+--- !ruby/object:Gem::Specification
+name: traitee
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Adam Lieskovsky
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  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: Traits for Ruby - more dynamic implementation of classic include/extend
+  feature.
+email:
+- adamliesko@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/traitee.rb
+- lib/traitee/conflict_solver.rb
+- lib/traitee/dict.rb
+- lib/traitee/merger.rb
+- lib/traitee/trait.rb
+- lib/traitee/version.rb
+homepage: http://github.com/adamliesko/traitee
+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: Mixins or so called traits for Ruby
+test_files: []