Acme-MetaSyntactic

 view release on metacpan or  search on metacpan

Changes  view on Meta::CPAN

    - pause_id
    [THEME UPDATES]
    - dilbert
    - planets (Pluto is not a planet anymore)
    - pornstars

0.88 2006-08-22 BOOK
    [NEW WEEKLY THEME 2006/08/21]
    - metro
    [AND FOR THE LAST TIME, METRO IS NOT NEW!]
    - ... but is has changed so much, that is just like it was.
    - From now on, Acme::MetaSyntactic has exactly 100 * $VERSION
      themes. Version 0.99 (the last beta) will ship with 99 themes.
    - No more cheap tricks to reduce the headcount, yay!
    [TESTS]
    - t/31any.t has been updated to work correctly if other themes
      are installed
    - t/41count.t is back (and works correctly if other themes are
      installed)
    [TICKET CLOSED]
    - #21028 on rt.cpan.org (David Adler noticed that t/31any.t failed)

Changes  view on Meta::CPAN

      when older versions of Acme::MetaSyntactic are already installed
      (that's because some themes have been renamed or removed)
    [THEME UPDATES]
    - apollo (augmented and renamed space_missions)
    - space_missions (Jean Forget)

0.85 2006-08-02 BOOK
    [NEW WEEKLY THEME 2006/07/31]
    - foo
    [GUESS WHAT? FOO IS NOT NEW!]
    - foo was made multilingual (see the change log for 0.26, 0.38,
      0.55, 0.70 and 0.73 for the whole list of cheap justifications)
    - only one more of those, and we'll have the version number correspond
      to the total number of themes
    [THEME UPDATES]
    - toto (removed and merged into foo)
    [OOPS]
    - Due to holidays and bad connection, this list was two days late.

0.84 2006-07-23 BOOK
    [NEW WEEKLY THEME 2006/07/24]

Changes  view on Meta::CPAN

    - dwarves (Abigail, 9 new languages)
    - phonetic (Gisbert W. Selke, German typo)
    - planets (Abigail, update to 42 languages)
    - pornstars
    - weekdays (Gisbert W. Selke, 10 new languages)

0.73 2006-04-30 BOOK
    [NEW WEEKLY THEME 2006/05/08]
    - planets
    [GUESS WHAT? PLANETS IS NOT NEW!]
    - planets was made multilingual (see the change log for
      0.26, 0.38, 0.55 and 0.70 for the whole list of cheap
      justifications)
    [ENHANCEMENTS]
    - Acme::MetaSyntactic::Locale is now a subclass of
      Acme::MetaSyntactic::MultiList, and supports territories.

0.72 2006-04-28 BOOK
    [NEW WEEKLY THEME 2006/05/01]
    - pantagruel (Rafaël Garcia-Suarez)
    [THEME UPDATES]

Changes  view on Meta::CPAN

0.71 2006-04-26 BOOK
    [NEW WEEKLY THEME 2006/04/24]
    - sql
    [THEME UPDATE]
    - pornstars

0.70 2006-04-16 BOOK
    [NEW WEEKLY THEME 2006/04/17]
    - jamesbond (Abigail)
    [HEY, JAMESBOND IS NOT NEW! IT WAS ADDED IN VERSION 0.07!!]
    - You know the story, now... (If not, see the change log for
      versions 0.26, 0.38 and 0.55.) This time I turned a simple
      list into one with categories.
    [ENHANCEMENTS]
    - The meta script can now be called with "meta theme/category"
      instead of "meta --category category theme". (Abigail)
    - meta now accepts a --sources switch, that lists the sources
      used by a remote list. (Abigail)
    [THEME UPDATES]
    - browser (Rafaël Garcia-Suarez added a new item)
    - pornstars

Changes  view on Meta::CPAN

0.56 2005-12-29 BOOK
    [NEW WEEKLY THEME 2006/01/09]
    - pokemon (Abigail)
    [THEME UPDATE]
    - pm_groups (28 groups died, 4 were created)

0.55 2005-12-27 BOOK
    [NEW WEEKLY THEME 2006/01/02]
    - weekdays
    [HEY, WEEKDAYS IS NOT NEW! IT WAS ADDED IN VERSION 0.51!!]
    - Well, the theme has changed enough that I can consider it
      new: it's now a subclass of Acme::MetaSyntactic::Locale
      and supports Basque, Catalan, Corsican, Danish, Dutch, English,
      Estonian, Finnish, French, German, Italian, Latin, Latvian,
      Polish, Portuguese, Spanish, Swahili, Swedish, Welsh and Yiddish
      lists (as well as the Pataphysical calendar).
    - You've being doing this three times already! What does it mean?
    - I must admit that it's the only way I've found to add something
      new each week and still manage to have only 100 themes when I
      reach version 1.00...

Changes  view on Meta::CPAN

    [ENHANCEMENTS]
    - Each theme now has a theme() method, for reflexion
    [TESTS]
    - the list validity is now tested for all locales for subclasses
      of Acme::MetaSyntactic::Locale (thanks to Gábor Szabó)

0.38 2005-08-24 BOOK
    [NEW WEEKLY THEME 2005/09/05]
    - phonetic
    [HEY, PHONETIC IS NOT NEW! IT WAS ADDED IN VERSION 0.08!!]
    - Well, the theme has changed enough that I can consider it
      new: it's now a subclass of Acme::MetaSyntactic::Locale,
      and supports Swahili, French, English, German and Italian
      lists (as well as the good old NATO).
    [TICKET CLOSED]
    - #14276 on rt.cpan.org (multilingual phonetic, with unofficial
      Swahili alphabet)

0.37 2005-08-23 BOOK
    [NEW WEEKLY THEME 2005/08/29]
    - jerkcity (Rafael Garcia-Suarez)

Changes  view on Meta::CPAN


0.27 2005-06-19 BOOK
    [NEW WEEKLY THEME 2005/06/20]
    - groo

0.26 2005-06-13 BOOK
    [NEW WEEKLY THEME 2005/06/13]
    - simpsons
    [HEY, SIMPSONS IS NOT NEW! IT WAS ADDED IN VERSION 0.04!!]
    - Sorry, the theme disappeared in version 0.12, when I made
      the change to the behaviour-based architecture
    - What's the point of having 100% coverage, when things like
      this happen?
    - Hey, nobody complained until now!

0.25 2005-06-06 BOOK
    [NEW WEEKLY THEME 2005/06/06]
    - pasta
    [BUG FIX]
    - magicroundabout had a BUG, which is now fixed (sorry about that)

Changes  view on Meta::CPAN

    - The first behaviour class is Acme::MetaSyntactic::List, which
      reproduces the previous behaviour of selecting a number
      of random items from a list, with no repetition until
      the list is exhausted.
    - The 17 existing themes have been converted to the new scheme.
    [USAGE]
    - Acme::MetaSyntactic is a dependency for a least one module!
      Praise Bot::MetaSyntactic, which is the core of the meta bot
      running on irc://irc.perl.org/perlfr
    [INCOMPATIBILITIES]
    - the API has changed a little:
      + Acme::MetaSyntactic does not has methods named after the
        themes any more
      + The name() method now accept the theme name as its first
        parameter
      + name( [ $theme, ] 0 ) now returns the full list of names
    [COVERAGE]
    - Code coverage is still 100%, but I had to resort to a hack
      to achieve this feat.
    [NEW BEHAVIOURS]
    - Acme::MetaSyntactic::List is the classic "random item from a list"

LICENSE  view on Meta::CPAN

 Copyright (C) 1989 Free Software Foundation, Inc.
 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

 Everyone is permitted to copy and distribute verbatim copies
 of this license document, but changing it is not allowed.

                            Preamble

  The license agreements of most software companies try to keep users
at the mercy of those companies.  By contrast, our General Public
License is intended to guarantee your freedom to share and change free
software--to make sure the software is free for all its users.  The
General Public License applies to the Free Software Foundation's
software and to any other program whose authors commit to using it.
You can use it for your programs, too.

  When we speak of free software, we are referring to freedom, not
price.  Specifically, the General Public License is designed to make
sure that you have the freedom to give away or sell copies of free
software, that you receive source code or can get it if you want it,
that you can change the software or use pieces of it in new free
programs; and that you know you can do these things.

  To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if you
distribute copies of the software, or if you modify it.

  For example, if you distribute copies of a such a program, whether
gratis or for a fee, you must give the recipients all the rights that
you have.  You must make sure that they, too, receive or can get the

LICENSE  view on Meta::CPAN

General Public License and to the absence of any warranty; and give any
other recipients of the Program a copy of this General Public License
along with the Program.  You may charge a fee for the physical act of
transferring a copy.

  2. You may modify your copy or copies of the Program or any portion of
it, and copy and distribute such modifications under the terms of Paragraph
1 above, provided that you also do the following:

    a) cause the modified files to carry prominent notices stating that
    you changed the files and the date of any change; and

    b) cause the whole of any work that you distribute or publish, that
    in whole or in part contains the Program or any part thereof, either
    with or without modifications, to be licensed at no charge to all
    third parties under the terms of this General Public License (except
    that you may choose to grant warranty protection to some or all
    third parties, at your option).

    c) If the modified program normally reads commands interactively when
    run, you must cause it, when started running for such interactive use
    in the simplest and most usual way, to print or display an
    announcement including an appropriate copyright notice and a notice
    that there is no warranty (or else, saying that you provide a
    warranty) and that users may redistribute the program under these
    conditions, and telling the user how to view a copy of this General
    Public License.

    d) You may charge a fee for the physical act of transferring a
    copy, and you may at your option offer warranty protection in
    exchange for a fee.

Mere aggregation of another independent work with the Program (or its
derivative) on a volume of a storage or distribution medium does not bring
the other work under the scope of these terms.

  3. You may copy and distribute the Program (or a portion or derivative of
it, under Paragraph 2) in object code or executable form under the terms of
Paragraphs 1 and 2 above provided that you also do one of the following:

    a) accompany it with the complete corresponding machine-readable

LICENSE  view on Meta::CPAN

YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.

                     END OF TERMS AND CONDITIONS

        Appendix: How to Apply These Terms to Your New Programs

  If you develop a new program, and you want it to be of the greatest
possible use to humanity, the best way to achieve this is to make it
free software which everyone can redistribute and change under these
terms.

  To do so, attach the following notices to the program.  It is safest to
attach them to the start of each source file to most effectively convey
the exclusion of warranty; and each file should have at least the
"copyright" line and a pointer to where the full notice is found.

    <one line to give the program's name and a brief idea of what it does.>
    Copyright (C) 19yy  <name of author>

LICENSE  view on Meta::CPAN


1. You may make and give away verbatim copies of the source form of the
Standard Version of this Package without restriction, provided that you
duplicate all of the original copyright notices and associated disclaimers.

2. You may apply bug fixes, portability fixes and other modifications derived
from the Public Domain or from the Copyright Holder. A Package modified in such
a way shall still be considered the Standard Version.

3. You may otherwise modify your copy of this Package in any way, provided that
you insert a prominent notice in each changed file stating how and when you
changed that file, and provided that you do at least ONE of the following:

  a) place your modifications in the Public Domain or otherwise make them
     Freely Available, such as by posting said modifications to Usenet or an
     equivalent medium, or placing the modifications on a major archive site
     such as ftp.uu.net, or by allowing the Copyright Holder to include your
     modifications in the Standard Version of the Package.

  b) use the modified Package only within your corporation or organization.

  c) rename any non-standard executables so the names do not conflict with

dist.ini  view on Meta::CPAN

[Git::NextVersion]

[TestRelease]
[ConfirmRelease]
[UploadToCPAN]

; git
[Git::Check]
[Git::Commit]
commit_msg  = Changes for version %v
changelog   = Changes

[Git::Tag]
tag_format  = v%v
tag_message = %N v%v

[Git::Push]
push_to     = origin
push_to     = github

lib/Acme/MetaSyntactic.pm  view on Meta::CPAN

=head1 EXPORTS

Depending on how C<Acme::MetaSyntactic> is used, several functions can
be exported. All of them behave like the following:

=over 4

=item metaname( [ $theme, ] $count )

Return C<$count> items from theme C<$theme>. If no theme is given,
the theme is "default" theme. See below how to change what the default is.

=back

=head2 Use cases

=over 4

=item C<use Acme::MetaSyntactic;>

This exports the C<metaname()> function only.

lib/Acme/MetaSyntactic.pm  view on Meta::CPAN


=head1 AUTHOR

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

=head1 BUGS

Please report any bugs or feature requests to
C<bug-acme-metasyntactic@rt.cpan.org>, or through the web interface at
L<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 (C<Acme::MetaSyntactic::List>,
C<Acme::MetaSyntactic::Locale>), or a new one of your invention).

=head1 ACKNOWLEDGEMENTS

Individual contributors are listed in the individual theme files.
Look at the included F<CONTRIBUTORS> file for the list of all

lib/Acme/MetaSyntactic.pm  view on Meta::CPAN


who actually uses it, to do what he thinks is the only logical thing
to do with C<Acme::MetaSyntactic>: an IRC bot! See L<Bot::MetaSyntactic>.

    #perlfr Sat Mar  5 01:15 CET 2005
    <Maddingue> BooK: bon, l'API de AMS, tu l'as changé alors ?
    <BooK> je sais pas
    <Maddingue> comment on fait pour invoquer ton merder
    <BooK> ca se mélange dans ma tete
    <BooK> je peux te montrer des use case
    <Maddingue> je veux juste savoir si tu vas changer la commande meta
    <Maddingue> BooK: parce que j'ai fais la seule chose qui me semblait
                logique de faire avec ton module
    <BooK> un robot irc

=item *

Jérôme Fenal,

who wrote L<Acme::MetaSyntactic::RefactorCode>, which helps
C<Acme::MetaSyntactic> fulfill its role: rename your boring variables

lib/Acme/MetaSyntactic/any.pm  view on Meta::CPAN

Always return false.

=back

=head1 CONTRIBUTOR

Philippe Bruhat, upon request of Sébastien Aperghis-Tramoni.

Introduced in Acme-MetaSyntactic version 0.12, published on March 7, 2005.

Updated to conform with interface changes required by
C<Acme::MetaSyntactic::Updatable> in version 0.49, published
on November 21, 2005.

Received its own version number for Acme-MetaSyntactic version 1.000,
published on May 7, 2012.

=head1 SEE ALSO

L<Acme::MetaSyntactic>.

script/meta  view on Meta::CPAN


B<meta> is the script of choice for a new generation of hackers.
Here are a few comments from satisfied users:

=over 4

=item *

I<C<Acme::MetaSyntactic> makes me more productive when I have to write
regression tests for my Perl modules. No more do I spend time looking
for variable names! It simply changed my life.>

-- Rafael Garcia-Suarez, pumpking,
used AMS when writing tests for C<Sub::Identify>.

=item *

I<C<Acme::MetaSyntactic> gave names for regression tests in the Perl core>

See L<https://github.com/Perl/perl5/commit/adc51b978ed1b2e9d4512c9bfa80386ac917d05a>.



( run in 0.281 second using v1.01-cache-2.11-cpan-5dc5da66d9d )