lib/MooseX/InsideOut.pm

   1 use strict;
   2 use warnings;
   3
   4 package MooseX::InsideOut;
   5
   6 use metaclass 'MooseX::InsideOut::Meta::Class';
   7 use Moose;
   8
   9 1;
  10 __END__
  11
  12 =head1 NAME
  13
  14 MooseX::InsideOut - inside-out objects with Moose
  15
  16 =head1 VERSION
  17
  18 Version 0.001
  19
  20 =cut
  21
  22 our $VERSION = '0.001';
  23
  24 =head1 SYNOPSIS
  25
  26   package My::Object;
  27
  28   use Moose;
  29   extends 'MooseX::InsideOut';
  30
  31   # ... normal Moose functionality
  32   # or ...
  33
  34   package My::Subclass;
  35
  36   use metaclass 'MooseX::InsideOut::Meta::Class';
  37   use Moose;
  38   extends 'Some::Other::Class;
  39
  40 =head1 DESCRIPTION
  41
  42 MooseX::InsideOut provides a metaclass and an instance metaclass for inside-out
  43 objects.
  44
  45 You can use MooseX::InsideOut as a normal base class, as in the first example
  46 in the L</SYNOPSIS>.
  47
  48 You can also use the metaclass C<MooseX::InsideOut::Meta::Class> directly, as
  49 in the second example.  This is most useful when extending a non-Moose class,
  50 whose internals you either don't want to care about or aren't hash-based.
  51
  52 =head1 TODO
  53
  54 =over
  55
  56 =item * dumping (for debugging purposes)
  57
  58 =item * serialization (for e.g. storable)
  59
  60 =item * (your suggestions here)
  61
  62 =back
  63
  64 =head1 AUTHOR
  65
  66 Hans Dieter Pearcey, C<< <hdp at pobox.com> >>
  67
  68 =head1 BUGS
  69
  70 Please report any bugs or feature requests to C<bug-moosex-insideout at rt.cpan.org>, or through
  71 the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=MooseX-InsideOut>.  I will be notified, and then you'll
  72 automatically be notified of progress on your bug as I make changes.
  73
  74 =head1 SUPPORT
  75
  76 You can find documentation for this module with the perldoc command.
  77
  78     perldoc MooseX::InsideOut
  79
  80
  81 You can also look for information at:
  82
  83 =over 4
  84
  85 =item * RT: CPAN's request tracker
  86
  87 L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=MooseX-InsideOut>
  88
  89 =item * AnnoCPAN: Annotated CPAN documentation
  90
  91 L<http://annocpan.org/dist/MooseX-InsideOut>
  92
  93 =item * CPAN Ratings
  94
  95 L<http://cpanratings.perl.org/d/MooseX-InsideOut>
  96
  97 =item * Search CPAN
  98
  99 L<http://search.cpan.org/dist/MooseX-InsideOut>
 100
 101 =back
 102
 103
 104 =head1 ACKNOWLEDGEMENTS
 105
 106
 107 =head1 COPYRIGHT & LICENSE
 108
 109 Copyright 2008 Hans Dieter Pearcey.
 110
 111 This program is free software; you can redistribute it and/or modify it
 112 under the same terms as Perl itself.
 113
 114 =cut