[catagits/Gitalist.git] / local-lib5 / lib / perl5 / oose.pm

package oose;

use strict;
use warnings;

use Class::MOP;

our $VERSION   = '0.93';
$VERSION = eval $VERSION;
our $AUTHORITY = 'cpan:STEVAN';

BEGIN {
    my $package;
    sub import {
        $package = $_[1] || 'Class';
        if ($package =~ /^\+/) {
            $package =~ s/^\+//;
            Class::MOP::load_class($package);
        }
    }
    use Filter::Simple sub { s/^/package $package;\nuse Moose;\n/; }
}

1;

__END__

=pod

=head1 NAME

oose - syntactic sugar to make Moose one-liners easier

=head1 SYNOPSIS

  # create a Moose class on the fly ...
  perl -Moose=Foo -e 'has bar => ( is=>q[ro], default => q[baz] ); print Foo->new->bar' # prints baz

  # loads an existing class (Moose or non-Moose)
  # and re-"opens" the package definition to make
  # debugging/introspection easier
  perl -Moose=+My::Class -e 'print join ", " => __PACKAGE__->meta->get_method_list'

=head1 DESCRIPTION

oose.pm is a simple source filter that adds C<package $name; use Moose;>
to the beginning of your script and was entirely created because typing
C<perl -e'package Foo; use Moose; ...'> was annoying me.

=head1 INTERFACE

oose provides exactly one method and it's automatically called by perl:

=over 4

=item B<import($package)>

Pass a package name to import to be used by the source filter.

=back

=head1 DEPENDENCIES

You will need L<Filter::Simple> and eventually L<Moose>

=head1 INCOMPATIBILITIES

None reported. But it is a source filter and might have issues there.

=head1 BUGS

All complex software has bugs lurking in it, and this module is no
exception. If you find a bug please either email me, or add the bug
to cpan-RT.

=head1 AUTHOR

Chris Prather  C<< <perigrin@cpan.org> >>

=head1 COPYRIGHT AND LICENSE

Copyright 2007-2009 by Infinity Interactive, Inc.

L<http://www.iinteractive.com>

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

=cut
Commit	Line	Data
3fea05b9	1	package oose;
	2
	3	use strict;
	4	use warnings;
	5
	6	use Class::MOP;
	7
	8	our $VERSION = '0.93';
	9	$VERSION = eval $VERSION;
	10	our $AUTHORITY = 'cpan:STEVAN';
	11
	12	BEGIN {
	13	my $package;
	14	sub import {
	15	$package = $_[1] \|\| 'Class';
	16	if ($package =~ /^\+/) {
	17	$package =~ s/^\+//;
	18	Class::MOP::load_class($package);
	19	}
	20	}
	21	use Filter::Simple sub { s/^/package $package;\nuse Moose;\n/; }
	22	}
	23
	24	1;
	25
	26	__END__
	27
	28	=pod
	29
	30	=head1 NAME
	31
	32	oose - syntactic sugar to make Moose one-liners easier
	33
	34	=head1 SYNOPSIS
	35
	36	# create a Moose class on the fly ...
	37	perl -Moose=Foo -e 'has bar => ( is=>q[ro], default => q[baz] ); print Foo->new->bar' # prints baz
	38
	39	# loads an existing class (Moose or non-Moose)
	40	# and re-"opens" the package definition to make
	41	# debugging/introspection easier
	42	perl -Moose=+My::Class -e 'print join ", " => __PACKAGE__->meta->get_method_list'
	43
	44	=head1 DESCRIPTION
	45
	46	oose.pm is a simple source filter that adds C<package $name; use Moose;>
	47	to the beginning of your script and was entirely created because typing
	48	C<perl -e'package Foo; use Moose; ...'> was annoying me.
	49
	50	=head1 INTERFACE
	51
	52	oose provides exactly one method and it's automatically called by perl:
	53
	54	=over 4
	55
	56	=item B<import($package)>
	57
	58	Pass a package name to import to be used by the source filter.
	59
	60	=back
	61
	62	=head1 DEPENDENCIES
	63
	64	You will need L<Filter::Simple> and eventually L<Moose>
65
66	=head1 INCOMPATIBILITIES
67
68	None reported. But it is a source filter and might have issues there.
69
70	=head1 BUGS
71
72	All complex software has bugs lurking in it, and this module is no
73	exception. If you find a bug please either email me, or add the bug
74	to cpan-RT.
75
76	=head1 AUTHOR
77
78	Chris Prather C<< <perigrin@cpan.org> >>
79
80	=head1 COPYRIGHT AND LICENSE
81
82	Copyright 2007-2009 by Infinity Interactive, Inc.
83
84	L<http://www.iinteractive.com>
85
86	This library is free software; you can redistribute it and/or modify
87	it under the same terms as Perl itself.
88
89	=cut