RubyGems Navigation menu

pluggability 0.6.0

Pluggability is a toolkit for creating plugins. It provides a mixin that extends your class with methods to load and instantiate its subclasses by name. So instead of: require 'acme/adapter/png' png_adapter = Acme::Adapter::PNG.new( 'file.png' ) you can do: require 'acme/adapter' png_adapter = Acme::Adapter.create( :png, 'file.png' ) A full example of where this might be useful is in a program which generates output with a 'driver' object, which provides a unified interface but generates different kinds of output. First the abstract base class, which is extended with Pluggability: # in mygem/driver.rb: require 'pluggability' require 'mygem' unless defined?( MyGem ) class MyGem::Driver extend Pluggability plugin_prefixes "mygem/drivers" end We can have one driver that outputs PDF documents: # mygem/drivers/pdf.rb: require 'mygem/driver' unless defined?( MyGem::Driver ) class MyGem::Driver::PDF < Driver ...implementation... end and another that outputs plain ascii text: #mygem/drivers/ascii.rb: require 'mygem/driver' unless defined?( MyGem::Driver ) class MyGem::Driver::ASCII < Driver ...implementation... end Now the driver is configurable by the end-user, who can just set it by its short name: require 'mygem' config[:driver_type] #=> "pdf" driver = MyGem::Driver.create( config[:driver_type] ) driver.class #=> MyGem::Driver::PDF # You can also pass arguments to the constructor, too: ascii_driver = MyGem::Driver.create( :ascii, :columns => 80 )

Gemfile:
= Copy to clipboard Copied!

install:
=

Versions:

  1. 0.9.0 - June 08, 2023 (18 KB)
  2. 0.8.0 - December 01, 2022 (18 KB)
  3. 0.7.0 - February 05, 2020 (23.5 KB)
  4. 0.6.0 - March 21, 2018 (25 KB)
  5. 0.5.0 - January 19, 2018 (25 KB)
Show all versions (14 total)

Runtime Dependencies (1):

loggability ~> 0.12

Development Dependencies (5):

hoe ~> 3.16
hoe-deveiate ~> 0.9
hoe-highline ~> 0.2
hoe-mercurial ~> 1.4
rdoc ~> 5.1

Owners:

Authors:

  • Martin Chase, Michael Granger

SHA 256 checksum:

= Copy to clipboard Copied!

Total downloads 43,600

For this version 4,388

License:

BSD-3-Clause

Required Ruby Version: >= 2.3.4

Links: