$ prove -lv t/some_test_file.t
$ prove -lvr t/
-In most cases, 'prove' is entirely sufficient for you to test any
-patches you have.
+In most cases, 'prove' is entirely sufficient for you to test any patches you
+have.
You may need to satisfy some dependencies. The easiest way to satisfy
dependencies is to install the last release -- this is available at
You can learn more about Dist::Zilla at http://dzil.org/.
The code for this distribution is hosted at GitHub. The repository is:
+
https://github.com/p5sagit/Try-Tiny
+
You can submit code changes by forking the repository, pushing your code
-changes to your clone, and then submitting a pull request. Detailed
-instructions for doing that is available here:
+changes to your clone, and then submitting a pull request. Please include a
+suitable end-user-oriented entry in the Changes file describing your change.
+Detailed instructions for doing that is available here:
https://help.github.com/articles/creating-a-pull-request
+All pull requests for this distribution will be automatically tested on Linux
+by Travis at: https://travis-ci.com/p5sagit/Try-Tiny
+Results will be visible in the pull request on GitHub. Follow the appropriate
+links for details when tests fail. Changes will not be mergeable until all
+tests pass.
+
If you have found a bug, but do not have an accompanying patch to fix it, you
can submit an issue report here:
https://rt.cpan.org/Public/Dist/Display.html?Name=Try-Tiny
request to the .mailmap file to contain the correct mapping.
-This file was generated via Dist::Zilla::Plugin::GenerateFile::FromShareDir 0.013 from a
-template file originating in Dist-Zilla-PluginBundle-Author-ETHER-0.132.
+This file was generated via Dist::Zilla::Plugin::GenerateFile::FromShareDir 0.015
+from a template file originating in Dist-Zilla-PluginBundle-Author-ETHER-0.161.
Revision history for Try-Tiny
-{{$NEXT}}
+0.31 2021-11-23 20:29:12Z
- plug Syntax::Keyword::Try and Feature::Compat::Try in the docs
0.30 2017-12-21 07:23:03Z
## Manual installation
-As a last resort, you can manually install it. Download the tarball, untar it,
-then build it:
+As a last resort, you can manually install it. If you have not already
+downloaded the release tarball, you can find the download link on the module's
+MetaCPAN page: https://metacpan.org/pod/Try::Tiny
+
+Untar the tarball, install configure prerequisites (see below), then build it:
% perl Makefile.PL
% make && make test
% make install
+On Windows platforms, you should use `dmake` or `nmake`, instead of `make`.
+
If your perl is system-managed, you can create a local::lib in your home
directory to install modules to. For details, see the local::lib documentation:
https://metacpan.org/pod/local::lib
+The prerequisites of this distribution will also have to be installed manually. The
+prerequisites are listed in one of the files: `MYMETA.yml` or `MYMETA.json` generated
+by running the manual build process described above.
+
+## Configure Prerequisites
+
+This distribution requires other modules to be installed before this
+distribution's installer can be run. They can be found under the
+"configure_requires" key of META.yml or the
+"{prereqs}{configure}{requires}" key of META.json.
+
+## Other Prerequisites
+
+This distribution may require additional modules to be installed after running
+Makefile.PL.
+Look for prerequisites in the following phases:
+
+* to run make, PHASE = build
+* to use the module code itself, PHASE = runtime
+* to run tests, PHASE = test
+
+They can all be found in the "PHASE_requires" key of MYMETA.yml or the
+"{prereqs}{PHASE}{requires}" key of MYMETA.json.
+
## Documentation
Try-Tiny documentation is available as POD.
-You can run perldoc from a shell to read the documentation:
+You can run `perldoc` from a shell to read the documentation:
% perldoc Try::Tiny
+
+For more information on installing Perl modules via CPAN, please see:
+https://www.cpan.org/modules/INSTALL.html
=head1 VERSION
-version 0.30
+version 0.31
=head1 SYNOPSIS
suppresses any errors. This behaviour is consistent with using a standalone
C<eval>, but it is not consistent with C<try>/C<finally> patterns found in
other programming languages, such as Java, Python, Javascript or C#. If you
-learnt the C<try>/C<finally> pattern from one of these languages, watch out for
+learned the C<try>/C<finally> pattern from one of these languages, watch out for
this.
=head1 EXPORTS
=over 4
+=item L<Syntax::Keyword::Try>
+
+Only available on perls >= 5.14, with a slightly different syntax (e.g. no trailing C<;> because
+it's actually a keyword, not a sub, but this means you can C<return> and C<next> within it). Use
+L<Feature::Compat::Try> to automatically switch to the native C<try> syntax in newer perls (when
+available). See also L<Try Catch Exception Handling|perlsyn/Try-Catch-Exception-Handling>.
+
=item L<TryCatch>
Much more feature complete, more convenient semantics, but at the cost of
=head1 CONTRIBUTORS
-=for stopwords Karen Etheridge Peter Rabbitson Ricardo Signes Mark Fowler Graham Knop Lukas Mai Aristotle Pagaltzis Dagfinn Ilmari Mannsåker Paul Howarth Rudolf Leermakers anaxagoras awalker chromatic Alex cm-perl Andrew Yates David Lowe Glenn Hans Dieter Pearcey Jens Berthold Jonathan Yu Marc Mims Stosberg Pali
+=for stopwords Karen Etheridge Peter Rabbitson Ricardo Signes Mark Fowler Graham Knop Aristotle Pagaltzis Dagfinn Ilmari Mannsåker Lukas Mai Alex anaxagoras Andrew Yates awalker chromatic cm-perl David Lowe Glenn Hans Dieter Pearcey Jens Berthold Jonathan Yu Marc Mims Stosberg Pali Paul Howarth Rudolf Leermakers
=over 4
=item *
-Lukas Mai <l.mai@web.de>
-
-=item *
-
Aristotle Pagaltzis <pagaltzis@gmx.de>
=item *
=item *
-Paul Howarth <paul@city-fan.org>
+Lukas Mai <l.mai@web.de>
=item *
-Rudolf Leermakers <rudolf@hatsuseno.org>
+Alex <alex@koban.(none)>
=item *
=item *
-awalker <awalker@sourcefire.com>
+Andrew Yates <ayates@haddock.local>
=item *
-chromatic <chromatic@wgz.org>
+awalker <awalker@sourcefire.com>
=item *
-Alex <alex@koban.(none)>
+chromatic <chromatic@wgz.org>
=item *
=item *
-Andrew Yates <ayates@haddock.local>
-
-=item *
-
David Lowe <davidl@lokku.com>
=item *
Pali <pali@cpan.org>
+=item *
+
+Paul Howarth <paul@city-fan.org>
+
+=item *
+
+Rudolf Leermakers <rudolf@hatsuseno.org>
+
=back
=head1 COPYRIGHT AND LICENCE
projects / p5sagit/Try-Tiny.git / commitdiff