SYNOPSIS

{
	package Human::Role;

	Class::Maker::class
	{
		public =>
		{
			string => [qw( name desc )],
		},

		default =>
		{
			name => 'Role Name',

			desc => 'Role Descrition',
		},
	};

	sub anew : method
	{
		my $this = shift;

		return $this->new( name => $_[0] );
	}

}

{
	package Human::Role::Simple;

	@ISA = qw(Human::Role);

	sub new : method
	{
		my $this = shift;

		return $this->SUPER::new( name => $_[0] );
	}
}

reflect

Now a Class::Maker::Reflex object is returned (btw it is not created with Class::Maker):

	->{parents} = href with all ->{isa} classes reflexes (only if $DEEP is true).

	->{methods} = aref of ': method' functions of that package

	->{def} = the original class definition (undef if not created with Class::Maker)

	->{isa} = the actual @ISA value of the class package

	->{name} = name of the reflected class

find

Returns a snapshot aref to all instances (objects) of a class in a given package.

CAVEAT: It only finds instance variables not created with 'my'

Example:

	# finds all objects which are return true for ->isa( 'Human' ) in the 'main' package

my $aref_humans = Class::Maker::Reflection::find( 'main' => 'Human' );

Comment:

This function is extremly inefficient, because it is traversing the complete symbol table instead of maintaning a registry of the classes/objects. This seems the lessest error-prone approach, and the time will show if there will be need for efficients.

Function classes

	classes( fakultativ $scalref_mainpackage, [ $package ], .. );

 Purpose

	Traverses the symbol table and find "reflectable" classes.	Returns a list of hash references containing:

		"package_identifier" => $HREF_CLASS_HASH

	Meaning it gets references to the reflection of the class.

	{ 'main::MyClass' => $href_myclass }, { 'main::YourClass' => $href_yclass }, ..