SYNOPSIS

    In dist.ini:

     [InsertBlock::FromModule]

    In lib/Your/Module.pm (that wants to embed one or more functions):

     # INSERT_BLOCK: Function::Embeddable import
     # INSERT_BLOCK: Function::Embeddable another_func

DESCRIPTION

    This module is a collection of functions that can be embedded into
    another file's source code, e.g. using
    Dist::Zilla::Plugin::InsertBlock::FromModule (if you're using
    Dist::Zilla to build your dists).

    The functions put here are usually routines that are small,
    independent, and stable (doesn't change that much). Instead of
    require-ing a module that contains these routines, a client code can
    opt to embed them directly in its file instead. The advantage is less
    dependencies (no other module to depend on) and slightly smaller
    startup overhead. Compared to manual "copy-pasting" of code, embedding
    using Dist::Zilla::Plugin::InsertBlock::FromModule is more
    maintainable.

FUNCTIONS

 import

    A lightweight Exporter-style exporter. Supports @EXPORT and @EXPORT_OK.
    No support for tags.

 pick(@list) => $item

    Pick a random item from a list. Will return undef if @ary is empty.

 pick_n($n, @list) => @items

    Pick $n items from a list.

 shuffle(@list) => @shuffled

    Just like List::Util's shuffle, except implemented in pure Perl and you
    don't have to load the module.

 uniq(@list) => @unique

    Just like List::MoreUtils's uniq, except implemented in pure Perl and
    you don't have to load the module.

SEE ALSO

    Dist::Zilla::Plugin::InsertBlock::FromModule

