(C) John Mair (banisterfiend) 2010
Ruby modules remixed and remastered
Remix is a library to give you total control over class and module ancestor chains.
Using Remix you can add a module at any point in the chain, remove modules, replace modules, move modules around and otherwise 'remix' your modules.
temp_include we can temporaliy mix in a module for the
duration of a block:
module def hello() :hello end end String.temp_include() do puts "test".hello #=> "hello" end "test".hello #=> NoMethodError
Like the Mixico library Remix allows you to unextend (or uninclude) modules from inheritance chains; but also extends this functionality by (optionally) removing nested modules too:
.ancestors #=> [C, A, B] o = .new o.extend o.singleton_class.ancestors #=> [C, A, B, Object, ...] # remove entire nested module C by passing true as second parameter o.unextend , true o.singleton_class.ancestors #=> [Object, ...]
Remix is intelligent enough to manipulate classes as well as modules:
class D < include end D.ancestors #=> [D, M, C] D.swap_modules , D.ancestors #=> [D, C, M]
It does this by first converting all superclasses to Included Modules before remixing takes place.
How it works
Remix is a C-based extension that directly manipulates the superclass pointers of Included Modules.
Remix is one of a series of experimental libraries that mess with the internals of Ruby to bring new and interesting functionality to the language, see also:
- Include Complete - Brings in module singleton classes during an include. No more ugly ClassMethods and included() hook hacks.
- Object2module - Convert Classes and Objects to Modules so they can be extended/included
- Prepend - Prepends modules in front of a class; so method lookup starts with the module
- GenEval - A strange new breed of instance_eval
Full list of functions
- include_at(index, mod)
- include_before(before_mod, mod)
- include_after(after_mod, mod)
- swap_modules(mod1, mod2)
- uninclude(mod, recurse=fale)
- replace_module(mod1, mod2)
- extend_at(index, mod)
- extend_before(before_mod, mod)
- extend_after(after_mod, mod)
- swap_extended_modules(mod1, mod2)
- unextend(mod, recurse=false)
- replace_extended_module(mod1, mod2)
Remix does not currently reorder the singleton classes of superclasses to reflect the new position of the class. This functionality is coming soon.
Problems or questions contact me at github
For Rue (1977-)