Class::Adapter - Perl implementation of the "Adapter" Design Pattern

       Adam Kennedy <adamk@cpan.org>

       •   Adam Kennedy <adam@ali.as>

       •   Karen Etheridge <ether@cpan.org>

       •   gregor herrmann <gregoa@debian.org>

       This software is copyright (c) 2005 by Adam Kennedy.

       This  is  free  software;  you  can  redistribute  it and/or modify it under the same terms as the Perl 5
       programming language system itself.

perl v5.36.0                                       2022-12-04                                Class::Adapter(3pm)

       The "Class::Adapter" class is intended as an abstract base class for creating any sort of class or object
       that follows the Adapter pattern.

   WhatisanAdapter?
       The term Adapter refers to a "DesignPattern" of the same name, from the famous "GangofFour" book
       "DesignPatterns". Although their original implementation was designed for Java and similar single-
       inheritance strictly-typed language, the situation for which it applies is still valid.

       An Adapter in this Perl sense of the term is when a class is created to achieve by composition (objects
       containing other object) something that can't be achieved by inheritance (sub-classing).

       This is similar to the Decorator pattern, but is intended to be applied on a class-by-class basis, as
       opposed to being able to be applied one object at a time, as is the case with the Decorator pattern.

       The "Class::Adapter" object holds a parent object that it "wraps", and when a method is called on the
       "Class::Adapter", it manually calls the same (or different) method with the same (or different)
       parameters on the parent object contained within it.

       Instead of these custom methods being hooked in on an object-by-object basis, they are defined at the
       class level.

       Basically, a "Class::Adapter" is one of your fall-back positions when Perl's inheritance model fails you,
       or is no longer good enough, and you need to do something twisty in order to make several APIs play
       nicely with each other.

   WhatcanIdowiththeactualClass::Adapterclass
       Well... nothing really. It exist to provide some extremely low level fundamental methods, and to provide
       a common base for inheritance of Adapter classes.

       The base "Class::Adapter" class doesn't even implement a way to push method calls through to the
       underlying object, since the way in which that happens is the bit that changes from case to case.

       To actually DO something, you probably want to go take a look at Class::Adapter::Builder, which makes the
       creation of Adapter classes relatively quick and easy.

       The "Class::Adapter" class itself supplies only the two most common methods, a default constructor and a
       private method to access the underlying object.

   new$object
       The default "new" constructor takes a single object as argument and creates a new object which holds the
       passed object.

       Returns a new "Class::Adapter" object, or "undef" if you do not pass in an object.

   _OBJECT_
       The "_OBJECT_" method is provided primarily as a convenience, and a tool for people implementing sub-
       classes, and allows the "Class::Adapter" interface to provide a guaranteed correct way of getting to the
       underlying object, should you need to do so.

       Class::Adapter - Perl implementation of the "Adapter" Design Pattern

       Class::Adapter::Clear, Class::Adapter::Builder, Class::Decorator

       Bugs may be submitted through the RT bug tracker
       <https://rt.cpan.org/Public/Dist/Display.html?Name=Class-Adapter> (or bug-Class-Adapter@rt.cpan.org
       <mailto:bug-Class-Adapter@rt.cpan.org>).

       - Write more comprehensive tests

       version 1.09