Project

mixes

0.0
No commit activity in last 3 years
No release in over 3 years
Load a Mixin with initial configuration.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

~> 1.7
~> 3.2
 Project Readme

Mixes

Simple Ruby objects mixin, with configuration.

Installation

Add this line to your application's Gemfile:

gem 'mixes'

And then execute:

$ bundle

Or install it yourself as:

$ gem install mixes

Usage

Plain object extending

Include your module inside any Ruby object using the mixes syntax:

module FooModule
  def instance_method
  end

  module ClassMethods
    def class_method
    end
  end
end

class FooClass
  mixes FooModule
end

FooModule module level methods would become instance methods within host object, and FooModule::ClassMethods methods would become class level methods.

Extending and configuring extended objects

You can pass a second argument to mixes method, holding the per-extension configuration values for module beeing mixed in.

class FooClass
  mixes FooModule, :foo
  # OR
  mixes FooModule, {foo: :bar}
  # OR
  mixes FooModule, [:foo, :bar]
  # OR
  # any other configuration values
end

This values would be available inside extended module throught the mixin_configuration class level accessor:

module FooModule
  def self.included(base)
    # prepare module host object based on values held by mixin_configuration
  end
end

class FooClass
  mixes FooModule, :foo
end

Contributing

  1. Fork it ( https://github.com/siemakuba/mixes/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request