The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Acme-MetaSyntactic-0.01
River stage two • 61 direct dependents • 63 total dependents
4 ++
/ Acme::MetaSyntactic

NAME

Acme::MetaSyntactic - Themed metasyntactic variables

SYNOPSIS

    use Acme::MetaSyntactic;

    my $meta = Acme::MetaSyntactic->new( 'shadok' );
    
    $meta->name;      # return a single name (at random) from the theme
    $meta->name( 4 ); # return 4 distinct names

    # you can temporarily switch theme (NOT RECOMMENDED)
    $meta->foo;       # return 1 name from theme foo
    $meta->foo(2);    # return 2 names from theme foo

DESCRIPTION

When writing code examples, it's always easy at the beginning:

    my $foo = "bar";
    $foo .= "baz";   # barbaz

But one gets quickly stuck with the same old boring examples. Does it have to be this way? I say "No".

Here is Acme::MetaSyntactic, designed to fulfill your metasyntactic needs. No more will you scratch your head in search of a good variable name!

METHODS & FUNCTIONS

Acme::MetaSyntactic has an object-oriented interface, as well as a functionnal one.

METHODS

If you choose to use the OO interface, the following methods are available:

new( $theme )

Create a new instance of Acme::MetaSyntactic with the theme $theme. If $theme is omitted, the default theme is foo.

name( $count )

Return $count items from the theme given in the constructor.

There is also one class method:

add_theme( theme => [ @items ], ... )

This class method adds a new theme to the list. It also creates all the convenience methods needed.

Convenience methods also exists for all the themes. The methods are named after the theme.

FUNCTIONS

The functional interface will be implemented in version 0.02.

THEMES

The following themes are available in this version:

batman

The fight sound effects from the 60s serial.

flintstones

The characters from the popular serial.

foo

The classic theme. This is the default theem

shadok

The whole shadok vocabulary. 4 words.

toto

The French metasyntactic names.

AUTHOR

Philippe 'BooK' Bruhat, <book@cpan.org>

BUGS

Please report any bugs or feature requests to bug-acme-metasyntactic@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

If you think this modules lacks a particular set of metasyntactic variables, please send me a list, as well as a generation algorithm (either one of the built-ins any, list, combine, or a new one from your invention)

ACKNOWLEDGEMENTS

This module could not have been possible without:

The Batman serial from the 60s (it was shown in France in the 80s).

All the bat sounds come from this page: http://www.usfamily.net/web/wpattinson/otr/batman/batfight.htm

RFC 3092 - Etymology of "Foo"
Some sillyness

See http://use.perl.org/~BooK/journal/22301.

Rafael Garcia-Suarez,

who apparently plans to use it.

COPYRIGHT & LICENSE

Copyright 2005 Philippe 'BooK' Bruhat, All Rights Reserved.

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