NAME
    Require::Util - Utilities related to require()
VERSION
    This document describes version 0.002 of Require::Util (from Perl
    distribution Require-Util), released on 2021-06-29.
SYNOPSIS
     use Require::Util qw(require_any try_require);
     if (try_require "Foo::Bar") {
         # use Foo::Bar's function
     }
     my $modname = require_any "Foo::Bar", "Baz/Qux.pm", "Quux";
DESCRIPTION
    EXPERIMENTAL.
FUNCTIONS
  require_any
    Usage:
     my $res = require_any $modname1, $modname2, ...;
    Example:
     my $res = require_any "Foo::Bar", "Baz/Qux.pm";
    Require modules listed as arguments, stopping after the first success.
    If all modules cannot be loaded, will die. Module name can be specified
    as "Foo::Bar" syntax or as "Foo/Bar.pm" syntax. Unlike "require()" which
    just returns true, upon success the function will return the module name
    that gets loaded.
  try_require
    Usage:
     my $res = try_require $modname;
    Example:
     my $res = try_require "Foo::Bar";
     my $res = try_require "Foo/Bar.pm";
    Try requiring specified module (wrapping the "require" statement in a
    "try/catch" block), returning true on success or false on failure
    (detail error message is stored in $Require::Util::err. Module name can
    be specified as "Foo::Bar" syntax or as "Foo/Bar.pm" syntax.
HOMEPAGE
    Please visit the project's homepage at
    <https://metacpan.org/release/Require-Util>.
SOURCE
    Source repository is at
    <https://github.com/perlancar/perl-Require-Util>.
BUGS
    Please report any bugs or feature requests on the bugtracker website
    <https://rt.cpan.org/Public/Dist/Display.html?Name=Require-Util>
    When submitting a bug or request, please include a test-file or a patch
    to an existing test-file that illustrates the bug or desired feature.
SEE ALSO
  Alternatives for "try_require"
    To simply check whether the module source is available without actually
    loading a file, use "module_installed" from Module::Installed::Tiny or
    "check_install" from Module::Load::Conditional. Module like
    Module::Path::More can also be used if you want to ignore @INC hooks.
  Alternatives for "require_any"
    Note that "can_load" from "Module::Load::Conditional" loads *all*
    modules instead of just one.
AUTHOR
    perlancar <perlancar@cpan.org>
COPYRIGHT AND LICENSE
    This software is copyright (c) 2021 by perlancar@cpan.org.
    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.