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