Build results of 2e68488 (on main)

.gitignore

@@ -1,9 +0,0 @@
-.test_info.*
-lastlog.jsonl
-*.bak
-lab
-.envrc
-*.orig
-*.tdy
-*.ERR
-Dancer2-Plugin-JsonApi-*

.travis.yml

@@ -1,17 +0,0 @@
----
-before_install:
-  - export HARNESS_OPTIONS=j10:c HARNESS_TIMER=1
-  - git config --global user.name "Dist Zilla Plugin TravisCI"
-  - git config --global user.email $HOSTNAME":not-for-mail@travis-ci.com"
-install:
-  - cpanm --with-recommends --installdeps -n .
-language: perl
-matrix:
-  include:
-    - perl: '5.22'
-    - perl: '5.24'
-    - perl: '5.26'
-    - perl: '5.28'
-    - perl: '5.30'
-script:
-  - prove -l t

Changes

@@ -1,18 +1,4 @@
 Revision history for Dancer2-Plugin-JsonApi
 
-{{$NEXT}}
+0.0.1 2023-11-15
-
+ - First release.
-    * First release.
-
- [API CHANGES]
-
- [BUG FIXES]
-
- [DOCUMENTATION]
-
- [ENHANCEMENTS]
-
- [NEW FEATURES]
-
- [STATISTICS]
-

INSTALL

@@ -0,0 +1,75 @@
+This is the Perl distribution Dancer2-Plugin-JsonApi.
+
+Installing Dancer2-Plugin-JsonApi is straightforward.
+
+## Installation with cpanm
+
+If you have cpanm, you only need one line:
+
+    % cpanm Dancer2::Plugin::JsonApi
+
+If it does not have permission to install modules to the current perl, cpanm
+will automatically set up and install to a local::lib in your home directory.
+See the local::lib documentation (https://metacpan.org/pod/local::lib) for
+details on enabling it in your environment.
+
+## Installing with the CPAN shell
+
+Alternatively, if your CPAN shell is set up, you should just be able to do:
+
+    % cpan Dancer2::Plugin::JsonApi
+
+## Manual installation
+
+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/Dancer2::Plugin::JsonApi
+
+Untar the tarball, install configure prerequisites (see below), then build it:
+
+    % perl Makefile.PL
+    % make && make test
+
+Then install it:
+
+    % 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
+
+Dancer2-Plugin-JsonApi documentation is available as POD.
+You can run `perldoc` from a shell to read the documentation:
+
+    % perldoc Dancer2::Plugin::JsonApi
+
+For more information on installing Perl modules via CPAN, please see:
+https://www.cpan.org/modules/INSTALL.html

LICENSE

@@ -0,0 +1,412 @@
+This software is copyright (c) 2023 by Yanick Champoux.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.
+
+Terms of the Perl programming language system itself
+
+a) the GNU General Public License as published by the Free
+   Software Foundation; either version 1, or (at your option) any
+   later version, or
+b) the "Artistic License"
+
+--- The GNU General Public License, Version 1, February 1989 ---
+
+This software is Copyright (c) 2023 by Yanick Champoux.
+
+This is free software, licensed under:
+
+  The GNU General Public License, Version 1, February 1989
+
+                    GNU GENERAL PUBLIC LICENSE
+                     Version 1, February 1989
+
+ 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
+source code.  And you must tell them their rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License Agreement applies to any program or other work which
+contains a notice placed by the copyright holder saying it may be
+distributed under the terms of this General Public License.  The
+"Program", below, refers to any such program or work, and a "work based
+on the Program" means either the Program or any work containing the
+Program or a portion of it, either verbatim or with modifications.  Each
+licensee is addressed as "you".
+
+  1. You may copy and distribute verbatim copies of the Program's source
+code as you receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice and
+disclaimer of warranty; keep intact all the notices that refer to this
+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
+    source code, which must be distributed under the terms of
+    Paragraphs 1 and 2 above; or,
+
+    b) accompany it with a written offer, valid for at least three
+    years, to give any third party free (except for a nominal charge
+    for the cost of distribution) a complete machine-readable copy of the
+    corresponding source code, to be distributed under the terms of
+    Paragraphs 1 and 2 above; or,
+
+    c) accompany it with the information you received as to where the
+    corresponding source code may be obtained.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form alone.)
+
+Source code for a work means the preferred form of the work for making
+modifications to it.  For an executable file, complete source code means
+all the source code for all modules it contains; but, as a special
+exception, it need not include source code for modules which are standard
+libraries that accompany the operating system on which the executable
+file runs, or for standard header files or definitions files that
+accompany that operating system.
+
+  4. You may not copy, modify, sublicense, distribute or transfer the
+Program except as expressly provided under this General Public License.
+Any attempt otherwise to copy, modify, sublicense, distribute or transfer
+the Program is void, and will automatically terminate your rights to use
+the Program under this License.  However, parties who have received
+copies, or rights to use copies, from you under this General Public
+License will not have their licenses terminated so long as such parties
+remain in full compliance.
+
+  5. By copying, distributing or modifying the Program (or any work based
+on the Program) you indicate your acceptance of this license to do so,
+and all its terms and conditions.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the original
+licensor to copy, distribute or modify the Program subject to these
+terms and conditions.  You may not impose any further restrictions on the
+recipients' exercise of the rights granted herein.
+
+  7. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Program
+specifies a version number of the license which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+the license, you may choose any version ever published by the Free Software
+Foundation.
+
+  8. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+                            NO WARRANTY
+
+  9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+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>
+
+    This program is free software; you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation; either version 1, or (at your option)
+    any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program; if not, write to the Free Software
+    Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA  02110-1301 USA
+
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) 19xx name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the
+appropriate parts of the General Public License.  Of course, the
+commands you use may be called something other than `show w' and `show
+c'; they could even be mouse-clicks or menu items--whatever suits your
+program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the
+  program `Gnomovision' (a program to direct compilers to make passes
+  at assemblers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+That's all there is to it!
+
+
+--- The Perl Artistic License 1.0 ---
+
+This software is Copyright (c) 2023 by Yanick Champoux.
+
+This is free software, licensed under:
+
+  The Perl Artistic License 1.0
+
+
+
+
+
+                         The "Artistic License"
+
+                                Preamble
+
+The intent of this document is to state the conditions under which a
+Package may be copied, such that the Copyright Holder maintains some
+semblance of artistic control over the development of the package,
+while giving the users of the package the right to use and distribute
+the Package in a more-or-less customary fashion, plus the right to make
+reasonable modifications.
+
+Definitions:
+
+        "Package" refers to the collection of files distributed by the
+        Copyright Holder, and derivatives of that collection of files
+        created through textual modification.
+
+        "Standard Version" refers to such a Package if it has not been
+        modified, or has been modified in accordance with the wishes
+        of the Copyright Holder as specified below.
+
+        "Copyright Holder" is whoever is named in the copyright or
+        copyrights for the package.
+
+        "You" is you, if you're thinking about copying or distributing
+        this Package.
+
+        "Reasonable copying fee" is whatever you can justify on the
+        basis of media cost, duplication charges, time of people involved,
+        and so on.  (You will not be required to justify it to the
+        Copyright Holder, but only to the computing community at large
+        as a market that must bear the fee.)
+
+        "Freely Available" means that no fee is charged for the item
+        itself, though there may be fees involved in handling the item.
+        It also means that recipients of the item may redistribute it
+        under the same conditions they received it.
+
+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 uunet.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 standard executables, which must also be provided, and provide
+    a separate manual page for each non-standard executable that clearly
+    documents how it differs from the Standard Version.
+
+    d) make other distribution arrangements with the Copyright Holder.
+
+4. You may distribute the programs of this Package in object code or
+executable form, provided that you do at least ONE of the following:
+
+    a) distribute a Standard Version of the executables and library files,
+    together with instructions (in the manual page or equivalent) on where
+    to get the Standard Version.
+
+    b) accompany the distribution with the machine-readable source of
+    the Package with your modifications.
+
+    c) give non-standard executables non-standard names, and clearly
+    document the differences in manual pages (or equivalent), together
+    with instructions on where to get the Standard Version.
+
+    d) make other distribution arrangements with the Copyright Holder.
+
+5. You may charge a reasonable copying fee for any distribution of this
+Package.  You may charge any fee you choose for support of this
+Package.  You may not charge a fee for this Package itself.  However,
+you may distribute this Package in aggregate with other (possibly
+commercial) programs as part of a larger (possibly commercial) software
+distribution provided that you do not advertise this Package as a
+product of your own.  You may embed this Package's interpreter within
+an executable of yours (by linking); this shall be construed as a mere
+form of aggregation, provided that the complete Standard Version of the
+interpreter is so embedded.
+
+6. The scripts and library files supplied as input to or produced as
+output from the programs of this Package do not automatically fall
+under the copyright of this Package, but belong to whoever generated
+them, and may be sold commercially, and may be aggregated with this
+Package.  If such scripts or library files are aggregated with this
+Package via the so-called "undump" or "unexec" methods of producing a
+binary executable image, then distribution of such an image shall
+neither be construed as a distribution of this Package nor shall it
+fall under the restrictions of Paragraphs 3 and 4, provided that you do
+not represent such an executable image as a Standard Version of this
+Package.
+
+7. C subroutines (or comparably compiled subroutines in other
+languages) supplied by you and linked into this Package in order to
+emulate subroutines and variables of the language defined by this
+Package shall not be considered part of this Package, but are the
+equivalent of input as in Paragraph 6, provided these subroutines do
+not change the language in any way that would cause it to fail the
+regression tests for the language.
+
+8. Aggregation of this Package with a commercial distribution is always
+permitted provided that the use of this Package is embedded; that is,
+when no overt attempt is made to make this Package's interfaces visible
+to the end user of the commercial distribution.  Such use shall not be
+construed as a distribution of this Package.
+
+9. The name of the Copyright Holder may not be used to endorse or promote
+products derived from this software without specific prior written permission.
+
+10. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+
+                                The End
+

META.json

@@ -0,0 +1,95 @@
+{
+   "abstract" : "JsonApi helpers for Dancer2 apps",
+   "author" : [
+      "Yanick Champoux <yanick@babyl.ca>"
+   ],
+   "dynamic_config" : 0,
+   "generated_by" : "Dist::Zilla version 6.030, CPAN::Meta::Converter version 2.150010",
+   "license" : [
+      "perl_5"
+   ],
+   "meta-spec" : {
+      "url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec",
+      "version" : 2
+   },
+   "name" : "Dancer2-Plugin-JsonApi",
+   "prereqs" : {
+      "configure" : {
+         "requires" : {
+            "ExtUtils::MakeMaker" : "0"
+         }
+      },
+      "develop" : {
+         "requires" : {
+            "Git::Wrapper" : "0",
+            "Test2::V0" : "0",
+            "Test::More" : "0.96",
+            "Test::PerlTidy" : "0",
+            "Test::Vars" : "0"
+         }
+      },
+      "runtime" : {
+         "requires" : {
+            "Carp" : "0",
+            "Dancer2::Core::Role::Serializer" : "0",
+            "Dancer2::Plugin" : "0",
+            "Dancer2::Serializer::JSON" : "0",
+            "List::AllUtils" : "0",
+            "Moo" : "0",
+            "Set::Object" : "0",
+            "experimental" : "0",
+            "perl" : "v5.38.0"
+         }
+      },
+      "test" : {
+         "recommends" : {
+            "CPAN::Meta" : "2.120900"
+         },
+         "requires" : {
+            "Clone" : "0",
+            "Dancer2" : "0",
+            "ExtUtils::MakeMaker" : "0",
+            "File::Spec" : "0",
+            "IO::Handle" : "0",
+            "IPC::Open3" : "0",
+            "JSON" : "0",
+            "Test2::Plugin::ExitSummary" : "0",
+            "Test2::V0" : "0",
+            "Test::More" : "0",
+            "strict" : "0",
+            "warnings" : "0"
+         }
+      }
+   },
+   "provides" : {
+      "Dancer2::Plugin::JsonApi" : {
+         "file" : "lib/Dancer2/Plugin/JsonApi.pm",
+         "version" : "v0.0.1"
+      },
+      "Dancer2::Plugin::JsonApi::Registry" : {
+         "file" : "lib/Dancer2/Plugin/JsonApi/Registry.pm",
+         "version" : "v0.0.1"
+      },
+      "Dancer2::Plugin::JsonApi::Schema" : {
+         "file" : "lib/Dancer2/Plugin/JsonApi/Schema.pm",
+         "version" : "v0.0.1"
+      },
+      "Dancer2::Serializer::JsonApi" : {
+         "file" : "lib/Dancer2/Serializer/JsonApi.pm",
+         "version" : "v0.0.1"
+      }
+   },
+   "release_status" : "stable",
+   "version" : "0.0.1",
+   "x_author_pledge" : {
+      "version" : 1
+   },
+   "x_authority" : "cpan:YANICK",
+   "x_contributor_covenant" : {
+      "version" : 0.02
+   },
+   "x_generated_by_perl" : "v5.38.0",
+   "x_serialization_backend" : "Cpanel::JSON::XS version 4.37",
+   "x_spdx_expression" : "Artistic-1.0-Perl OR GPL-1.0-or-later"
+}
+

META.yml

@@ -0,0 +1,58 @@
+---
+abstract: 'JsonApi helpers for Dancer2 apps'
+author:
+  - 'Yanick Champoux <yanick@babyl.ca>'
+build_requires:
+  Clone: '0'
+  Dancer2: '0'
+  ExtUtils::MakeMaker: '0'
+  File::Spec: '0'
+  IO::Handle: '0'
+  IPC::Open3: '0'
+  JSON: '0'
+  Test2::Plugin::ExitSummary: '0'
+  Test2::V0: '0'
+  Test::More: '0'
+  strict: '0'
+  warnings: '0'
+configure_requires:
+  ExtUtils::MakeMaker: '0'
+dynamic_config: 0
+generated_by: 'Dist::Zilla version 6.030, CPAN::Meta::Converter version 2.150010'
+license: perl
+meta-spec:
+  url: http://module-build.sourceforge.net/META-spec-v1.4.html
+  version: '1.4'
+name: Dancer2-Plugin-JsonApi
+provides:
+  Dancer2::Plugin::JsonApi:
+    file: lib/Dancer2/Plugin/JsonApi.pm
+    version: v0.0.1
+  Dancer2::Plugin::JsonApi::Registry:
+    file: lib/Dancer2/Plugin/JsonApi/Registry.pm
+    version: v0.0.1
+  Dancer2::Plugin::JsonApi::Schema:
+    file: lib/Dancer2/Plugin/JsonApi/Schema.pm
+    version: v0.0.1
+  Dancer2::Serializer::JsonApi:
+    file: lib/Dancer2/Serializer/JsonApi.pm
+    version: v0.0.1
+requires:
+  Carp: '0'
+  Dancer2::Core::Role::Serializer: '0'
+  Dancer2::Plugin: '0'
+  Dancer2::Serializer::JSON: '0'
+  List::AllUtils: '0'
+  Moo: '0'
+  Set::Object: '0'
+  experimental: '0'
+  perl: v5.38.0
+version: 0.0.1
+x_author_pledge:
+  version: 1
+x_authority: cpan:YANICK
+x_contributor_covenant:
+  version: 0.02
+x_generated_by_perl: v5.38.0
+x_serialization_backend: 'YAML::Tiny version 1.74'
+x_spdx_expression: 'Artistic-1.0-Perl OR GPL-1.0-or-later'

Makefile.PL

@@ -0,0 +1,83 @@
+# This file was automatically generated by Dist::Zilla::Plugin::MakeMaker v6.030.
+use strict;
+use warnings;
+
+use 5.038000;
+
+use ExtUtils::MakeMaker;
+
+my %WriteMakefileArgs = (
+  "ABSTRACT" => "JsonApi helpers for Dancer2 apps",
+  "AUTHOR" => "Yanick Champoux <yanick\@babyl.ca>",
+  "CONFIGURE_REQUIRES" => {
+    "ExtUtils::MakeMaker" => 0
+  },
+  "DISTNAME" => "Dancer2-Plugin-JsonApi",
+  "LICENSE" => "perl",
+  "MIN_PERL_VERSION" => "5.038000",
+  "NAME" => "Dancer2::Plugin::JsonApi",
+  "PREREQ_PM" => {
+    "Carp" => 0,
+    "Dancer2::Core::Role::Serializer" => 0,
+    "Dancer2::Plugin" => 0,
+    "Dancer2::Serializer::JSON" => 0,
+    "List::AllUtils" => 0,
+    "Moo" => 0,
+    "Set::Object" => 0,
+    "experimental" => 0
+  },
+  "TEST_REQUIRES" => {
+    "Clone" => 0,
+    "Dancer2" => 0,
+    "ExtUtils::MakeMaker" => 0,
+    "File::Spec" => 0,
+    "IO::Handle" => 0,
+    "IPC::Open3" => 0,
+    "JSON" => 0,
+    "Test2::Plugin::ExitSummary" => 0,
+    "Test2::V0" => 0,
+    "Test::More" => 0,
+    "strict" => 0,
+    "warnings" => 0
+  },
+  "VERSION" => "0.0.1",
+  "test" => {
+    "TESTS" => "t/*.t"
+  }
+);
+
+
+my %FallbackPrereqs = (
+  "Carp" => 0,
+  "Clone" => 0,
+  "Dancer2" => 0,
+  "Dancer2::Core::Role::Serializer" => 0,
+  "Dancer2::Plugin" => 0,
+  "Dancer2::Serializer::JSON" => 0,
+  "ExtUtils::MakeMaker" => 0,
+  "File::Spec" => 0,
+  "IO::Handle" => 0,
+  "IPC::Open3" => 0,
+  "JSON" => 0,
+  "List::AllUtils" => 0,
+  "Moo" => 0,
+  "Set::Object" => 0,
+  "Test2::Plugin::ExitSummary" => 0,
+  "Test2::V0" => 0,
+  "Test::More" => 0,
+  "experimental" => 0,
+  "strict" => 0,
+  "warnings" => 0
+);
+
+
+unless ( eval { ExtUtils::MakeMaker->VERSION(6.63_03) } ) {
+  delete $WriteMakefileArgs{TEST_REQUIRES};
+  delete $WriteMakefileArgs{BUILD_REQUIRES};
+  $WriteMakefileArgs{PREREQ_PM} = \%FallbackPrereqs;
+}
+
+delete $WriteMakefileArgs{CONFIGURE_REQUIRES}
+  unless eval { ExtUtils::MakeMaker->VERSION(6.52) };
+
+WriteMakefile(%WriteMakefileArgs);

README.mkdn

@@ -0,0 +1,31 @@
+# NAME
+
+Dancer2::Plugin::JsonApi - JsonApi helpers for Dancer2 apps
+
+# VERSION
+
+version 0.0.1
+
+# NAME
+
+Dancer2::Plugin::JsonAPI
+
+## DESCRIPTION
+
+If the serializer is not already explicitly set, the plugin will configure it to be [Dancer2::Serializer::JsonApi](https://metacpan.org/pod/Dancer2%3A%3ASerializer%3A%3AJsonApi).
+
+## SEE ALSO
+
+- The [JSON:API](https://jsonapi.org) specs, natch.
+- [json-api-serializer](https://www.npmjs.com/package/json-api-serializer) My go to for serializing JSON API documents in JavaScript-land. Also, inspiration for this module.
+
+# AUTHOR
+
+Yanick Champoux <yanick@babyl.ca> [![endorse](http://api.coderwall.com/yanick/endorsecount.png)](http://coderwall.com/yanick)
+
+# COPYRIGHT AND LICENSE
+
+This software is copyright (c) 2023 by Yanick Champoux.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.

doap.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<Project
+  xmlns="http://usefulinc.com/ns/doap#"
+  xmlns:dc="http://purl.org/dc/terms/"
+  xmlns:foaf="http://xmlns.com/foaf/0.1/"
+  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+  xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
+  >
+  <name>Dancer2-Plugin-JsonApi</name>
+  <shortdesc>JsonApi helpers for Dancer2 apps</shortdesc>
+  <developer>
+    <foaf:Person>
+      <foaf:name>Yanick Champoux</foaf:name>
+      <foaf:mbox rdf:resource="mailto:yanick@babyl.ca" />
+    </foaf:Person>
+  </developer>
+  <license rdf:resource="http://dev.perl.org/licenses/" />
+  <programming-language>Perl</programming-language>
+</Project>

lib/Dancer2/Plugin/JsonApi.pm

@@ -3,7 +3,8 @@
 use 5.38.0;
 
 package Dancer2::Plugin::JsonApi;
-
+our $AUTHORITY = 'cpan:YANICK';
+$Dancer2::Plugin::JsonApi::VERSION = '0.0.1';
 use Dancer2::Plugin::JsonApi::Registry;
 use Dancer2::Plugin;
 use Dancer2::Serializer::JsonApi;
@@ -50,6 +51,18 @@ sub BUILD ( $self, @ ) {
 
 __END__
 
+=pod
+
+=encoding UTF-8
+
+=head1 NAME
+
+Dancer2::Plugin::JsonApi - JsonApi helpers for Dancer2 apps
+
+=head1 VERSION
+
+version 0.0.1
+
 =head1 NAME
 
 Dancer2::Plugin::JsonAPI
@@ -68,3 +81,15 @@ If the serializer is not already explicitly set, the plugin will configure it to
 
 =back
 
+=head1 AUTHOR
+
+Yanick Champoux <yanick@babyl.ca>
+
+=head1 COPYRIGHT AND LICENSE
+
+This software is copyright (c) 2023 by Yanick Champoux.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.
+
+=cut

lib/Dancer2/Plugin/JsonApi/Registry.pm

@@ -1,5 +1,6 @@
 package Dancer2::Plugin::JsonApi::Registry;
-
+our $AUTHORITY = 'cpan:YANICK';
+$Dancer2::Plugin::JsonApi::Registry::VERSION = '0.0.1';
 use 5.32.0;
 use Dancer2::Plugin::JsonApi::Schema;
 
@@ -46,3 +47,47 @@ sub type ( $self, $type ) {
 1;
 
 __END__
+
+=pod
+
+=encoding UTF-8
+
+=head1 NAME
+
+Dancer2::Plugin::JsonApi::Registry
+
+=head1 VERSION
+
+version 0.0.1
+
+=head1 DESCRIPTION
+
+The registry for the different types of data managed by the plugin.
+
+=head1 METHODS
+
+=head2 add_type($type, $definition = {})
+
+Adds a data type to the registry.
+
+=head2 type($type)
+
+Returns the type's C<Dancer2::Plugin::JsonApi::Schema>. Throws an
+error if the type does not exist.
+
+=head2 serialize($type,$data,$extra_data={})
+
+Returns the serialized form of C<$data>.
+
+=head1 AUTHOR
+
+Yanick Champoux <yanick@babyl.ca>
+
+=head1 COPYRIGHT AND LICENSE
+
+This software is copyright (c) 2023 by Yanick Champoux.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.
+
+=cut

lib/Dancer2/Plugin/JsonApi/Registry.pod

@@ -1,23 +0,0 @@
-
-=head1 DESCRIPTION
-
-The registry for the different types of data managed by the plugin.
-
-=head1 METHODS
-
-=head2 add_type($type, $definition = {})
-
-Adds a data type to the registry.
-
-=head2 type($type)
-
-Returns the type's C<Dancer2::Plugin::JsonApi::Schema>. Throws an
-error if the type does not exist.
-
-=cut
-
-=head2 serialize($type,$data,$extra_data={})
-
-Returns the serialized form of C<$data>.
-
-=cut

lib/Dancer2/Plugin/JsonApi/Schema.pm

@@ -1,7 +1,8 @@
 use 5.32.0;
 
 package Dancer2::Plugin::JsonApi::Schema;
-
+our $AUTHORITY = 'cpan:YANICK';
+$Dancer2::Plugin::JsonApi::Schema::VERSION = '0.0.1';
 use Moo;
 
 use experimental   qw/ signatures /;
@@ -221,3 +222,94 @@ sub deserialize_data ( $self, $data, $included ) {
 }
 
 1;
+
+__END__
+
+=pod
+
+=encoding UTF-8
+
+=head1 NAME
+
+Dancer2::Plugin::JsonApi::Schema
+
+=head1 VERSION
+
+version 0.0.1
+
+=head1 DESCRIPTION
+
+Defines a type of object to serialize/deserialize from/to the 
+JSON:API format.
+
+=head1 ATTRIBUTES
+
+=head2 registry
+
+L<Dancer2::Plugin::JsonApi::Registry> to use to find the definition of
+other object types.
+
+=head2 before_serialize
+
+Accepts a function, which will be called on the original C<$data> to serialize
+to groom it.
+
+    before_serialize => sub($data,$xtra) {
+       # lowercase all keys
+       return +{ pairmap { lc($a) => $b } %$data } 
+    }
+
+=head2 type
+
+The JSON:API object type. Read-only, required.
+
+=head2 id
+
+Key to use as a reference to the object. Can be a string,
+or a function that will be passed the original data object.
+Read-only, defaults to the string C<id>. 
+
+=head2 links 
+
+Links to include as part of the object. 
+
+=head2 top_level_links
+
+Links to include to the serialized top level, if the top level object 
+is of the type defined by this class.
+
+=head2 top_level_meta
+
+Meta information to include to the serialized top level, if the top level object 
+is of the type defined by this class.
+
+=head2 relationships
+
+Relationships for the object type.
+
+=head2 allowed_attributes
+
+List of attributes that can be serialized/deserialized.
+
+=head1 METHODS
+
+=head2 top_level_serialize($data,$extra_data = {})
+
+Serializes C<$data> as a top-level JSON:API object. 
+
+=head2 serialize_data($data,$extra_data)
+
+Serializes the inner C<$data>. 
+
+=head1 AUTHOR
+
+Yanick Champoux <yanick@babyl.ca>
+
+=head1 COPYRIGHT AND LICENSE
+
+This software is copyright (c) 2023 by Yanick Champoux.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.
+
+=cut

lib/Dancer2/Plugin/JsonApi/Schema.pod

@@ -1,64 +0,0 @@
-
-=head1 DESCRIPTION
-
-Defines a type of object to serialize/deserialize from/to the 
-JSON:API format.
-
-=head1 ATTRIBUTES
-
-=head2 registry
-
-L<Dancer2::Plugin::JsonApi::Registry> to use to find the definition of
-other object types.
-
-=head2 before_serialize
-
-Accepts a function, which will be called on the original C<$data> to serialize
-to groom it.
-
-    before_serialize => sub($data,$xtra) {
-       # lowercase all keys
-       return +{ pairmap { lc($a) => $b } %$data } 
-    }
-
-=head2 type
-
-The JSON:API object type. Read-only, required.
-
-=head2 id
-
-Key to use as a reference to the object. Can be a string,
-or a function that will be passed the original data object.
-Read-only, defaults to the string C<id>. 
-
-=head2 links 
-
-Links to include as part of the object. 
-
-=head2 top_level_links
-
-Links to include to the serialized top level, if the top level object 
-is of the type defined by this class.
-
-=head2 top_level_meta
-
-Meta information to include to the serialized top level, if the top level object 
-is of the type defined by this class.
-
-=head2 relationships
-
-Relationships for the object type.
-
-=head2 allowed_attributes
-
-List of attributes that can be serialized/deserialized.
-
-=head1 METHODS
-
-=head2 top_level_serialize($data,$extra_data = {})
-
-Serializes C<$data> as a top-level JSON:API object. 
-
-=head2 serialize_data($data,$extra_data)
-
-Serializes the inner C<$data>. 

lib/Dancer2/Serializer/JsonApi.pm

@@ -1,12 +1,60 @@
 use 5.38.0;
 
-=head1 DESCRIPTION
 
-Serializer for JSON:API. Takes in a data structure, munge it to conforms to the JSON:API format (potentially based on a provided registry of JSON:API schemas),
+package Dancer2::Serializer::JsonApi;
-and encode it as JSON.
+our $AUTHORITY = 'cpan:YANICK';
+$Dancer2::Serializer::JsonApi::VERSION = '0.0.1';
+use Dancer2::Plugin::JsonApi::Registry;
+use Dancer2::Serializer::JSON;
 
-Note that using Dancer2::Plugin::JsonApi in an app will automatically
+use Moo;
-set C<Dancer2::Serializer::JsonApi> as its serializer if it's not already defined.
+
+
+has content_type => ( is => 'ro', default => 'application/vnd.api+json' );
+
+with 'Dancer2::Core::Role::Serializer';
+
+
+has registry => (
+    is      => 'rw',
+    default => sub { Dancer2::Plugin::JsonApi::Registry->new }
+);
+
+
+has json_serializer => (
+    is      => 'ro',
+    default => sub { Dancer2::Serializer::JSON->new }
+);
+
+
+sub serialize {
+    my ( $self, $data ) = @_;
+
+    return $self->json_serializer->serialize(
+        $self->registry->serialize(@$data) );
+}
+
+
+sub deserialize ( $self, $serialized, @ ) {
+    $self->registry->deserialize(
+        $self->json_serializer->deserialize($serialized) );
+}
+
+1;
+
+__END__
+
+=pod
+
+=encoding UTF-8
+
+=head1 NAME
+
+Dancer2::Serializer::JsonApi
+
+=head1 VERSION
+
+version 0.0.1
 
 =head1 SYNOPSIS
 
@@ -46,14 +94,13 @@ As a standalone module:
         }
     ]);
 
-=cut 
+=head1 DESCRIPTION
 
-package Dancer2::Serializer::JsonApi;
+Serializer for JSON:API. Takes in a data structure, munge it to conforms to the JSON:API format (potentially based on a provided registry of JSON:API schemas),
+and encode it as JSON.
 
-use Dancer2::Plugin::JsonApi::Registry;
+Note that using Dancer2::Plugin::JsonApi in an app will automatically
-use Dancer2::Serializer::JSON;
+set C<Dancer2::Serializer::JsonApi> as its serializer if it's not already defined.
-
-use Moo;
 
 =head1 ATTRIBUTES
 
@@ -61,34 +108,14 @@ use Moo;
 
 Returns the content type used by the serializer, which is C<application/vnd.api+json>;
 
-=cut
-
-has content_type => ( is => 'ro', default => 'application/vnd.api+json' );
-
-with 'Dancer2::Core::Role::Serializer';
-
 =head2 registry 
 
 The L<Dancer2::Plugin::JsonApi::Registry> to use. 
 
-=cut
-
-has registry => (
-    is      => 'rw',
-    default => sub { Dancer2::Plugin::JsonApi::Registry->new }
-);
-
 =head2 json_serializer
 
 The underlying JSON serializer. Defaults to L<Dancer2::Serializer::JSON>.
 
-=cut
-
-has json_serializer => (
-    is      => 'ro',
-    default => sub { Dancer2::Serializer::JSON->new }
-);
-
 =head1 METHODS
 
 =head2 $self->serialize( [ $type, $data, $xtra ])
@@ -96,24 +123,19 @@ has json_serializer => (
 Serializes the C<$data> using the C<$type> from the registry. 
 The returned value will be a JSON string.
 
-=cut
-
-sub serialize {
-    my ( $self, $data ) = @_;
-
-    return $self->json_serializer->serialize(
-        $self->registry->serialize(@$data) );
-}
-
 =head2 $self->deserialize( $json_string )
 
 Takes in the serialized C<$json_string> and recreate data out of it.
 
+=head1 AUTHOR
+
+Yanick Champoux <yanick@babyl.ca>
+
+=head1 COPYRIGHT AND LICENSE
+
+This software is copyright (c) 2023 by Yanick Champoux.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.
+
 =cut
-
-sub deserialize ( $self, $serialized, @ ) {
-    $self->registry->deserialize(
-        $self->json_serializer->deserialize($serialized) );
-}
-
-1;

t/00-compile.t

@@ -0,0 +1,63 @@
+use 5.006;
+use strict;
+use warnings;
+
+# this test was generated with Dist::Zilla::Plugin::Test::Compile 2.058
+
+use Test::More;
+
+plan tests => 4 + ($ENV{AUTHOR_TESTING} ? 1 : 0);
+
+my @module_files = (
+    'Dancer2/Plugin/JsonApi.pm',
+    'Dancer2/Plugin/JsonApi/Registry.pm',
+    'Dancer2/Plugin/JsonApi/Schema.pm',
+    'Dancer2/Serializer/JsonApi.pm'
+);
+
+
+
+# no fake home requested
+
+my @switches = (
+    -d 'blib' ? '-Mblib' : '-Ilib',
+);
+
+use File::Spec;
+use IPC::Open3;
+use IO::Handle;
+
+open my $stdin, '<', File::Spec->devnull or die "can't open devnull: $!";
+
+my @warnings;
+for my $lib (@module_files)
+{
+    # see L<perlfaq8/How can I capture STDERR from an external command?>
+    my $stderr = IO::Handle->new;
+
+    diag('Running: ', join(', ', map { my $str = $_; $str =~ s/'/\\'/g; q{'} . $str . q{'} }
+            $^X, @switches, '-e', "require q[$lib]"))
+        if $ENV{PERL_COMPILE_TEST_DEBUG};
+
+    my $pid = open3($stdin, '>&STDERR', $stderr, $^X, @switches, '-e', "require q[$lib]");
+    binmode $stderr, ':crlf' if $^O eq 'MSWin32';
+    my @_warnings = <$stderr>;
+    waitpid($pid, 0);
+    is($?, 0, "$lib loaded ok");
+
+    shift @_warnings if @_warnings and $_warnings[0] =~ /^Using .*\bblib/
+        and not eval { +require blib; blib->VERSION('1.01') };
+
+    if (@_warnings)
+    {
+        warn @_warnings;
+        push @warnings, @_warnings;
+    }
+}
+
+
+
+is(scalar(@warnings), 0, 'no warnings found')
+    or diag 'got warnings: ', ( Test::More->can('explain') ? Test::More::explain(\@warnings) : join("\n", '', @warnings) ) if $ENV{AUTHOR_TESTING};
+
+

t/00-report-prereqs.dd

@@ -0,0 +1,50 @@
+do { my $x = {
+       'configure' => {
+                        'requires' => {
+                                        'ExtUtils::MakeMaker' => '0'
+                                      }
+                      },
+       'develop' => {
+                      'requires' => {
+                                      'Git::Wrapper' => '0',
+                                      'Test2::V0' => '0',
+                                      'Test::More' => '0.96',
+                                      'Test::PerlTidy' => '0',
+                                      'Test::Vars' => '0'
+                                    }
+                    },
+       'runtime' => {
+                      'requires' => {
+                                      'Carp' => '0',
+                                      'Dancer2::Core::Role::Serializer' => '0',
+                                      'Dancer2::Plugin' => '0',
+                                      'Dancer2::Serializer::JSON' => '0',
+                                      'List::AllUtils' => '0',
+                                      'Moo' => '0',
+                                      'Set::Object' => '0',
+                                      'experimental' => '0',
+                                      'perl' => 'v5.38.0'
+                                    }
+                    },
+       'test' => {
+                   'recommends' => {
+                                     'CPAN::Meta' => '2.120900'
+                                   },
+                   'requires' => {
+                                   'Clone' => '0',
+                                   'Dancer2' => '0',
+                                   'ExtUtils::MakeMaker' => '0',
+                                   'File::Spec' => '0',
+                                   'IO::Handle' => '0',
+                                   'IPC::Open3' => '0',
+                                   'JSON' => '0',
+                                   'Test2::Plugin::ExitSummary' => '0',
+                                   'Test2::V0' => '0',
+                                   'Test::More' => '0',
+                                   'strict' => '0',
+                                   'warnings' => '0'
+                                 }
+                 }
+     };
+  $x;
+ }

t/00-report-prereqs.t

@@ -0,0 +1,197 @@
+#!perl
+
+use strict;
+use warnings;
+
+# This test was generated by Dist::Zilla::Plugin::Test::ReportPrereqs 0.029
+
+use Test::More tests => 1;
+
+use ExtUtils::MakeMaker;
+use File::Spec;
+
+# from $version::LAX
+my $lax_version_re =
+    qr/(?: undef | (?: (?:[0-9]+) (?: \. | (?:\.[0-9]+) (?:_[0-9]+)? )?
+            |
+            (?:\.[0-9]+) (?:_[0-9]+)?
+        ) | (?:
+            v (?:[0-9]+) (?: (?:\.[0-9]+)+ (?:_[0-9]+)? )?
+            |
+            (?:[0-9]+)? (?:\.[0-9]+){2,} (?:_[0-9]+)?
+        )
+    )/x;
+
+# hide optional CPAN::Meta modules from prereq scanner
+# and check if they are available
+my $cpan_meta = "CPAN::Meta";
+my $cpan_meta_pre = "CPAN::Meta::Prereqs";
+my $HAS_CPAN_META = eval "require $cpan_meta; $cpan_meta->VERSION('2.120900')" && eval "require $cpan_meta_pre"; ## no critic
+
+# Verify requirements?
+my $DO_VERIFY_PREREQS = 1;
+
+sub _max {
+    my $max = shift;
+    $max = ( $_ > $max ) ? $_ : $max for @_;
+    return $max;
+}
+
+sub _merge_prereqs {
+    my ($collector, $prereqs) = @_;
+
+    # CPAN::Meta::Prereqs object
+    if (ref $collector eq $cpan_meta_pre) {
+        return $collector->with_merged_prereqs(
+            CPAN::Meta::Prereqs->new( $prereqs )
+        );
+    }
+
+    # Raw hashrefs
+    for my $phase ( keys %$prereqs ) {
+        for my $type ( keys %{ $prereqs->{$phase} } ) {
+            for my $module ( keys %{ $prereqs->{$phase}{$type} } ) {
+                $collector->{$phase}{$type}{$module} = $prereqs->{$phase}{$type}{$module};
+            }
+        }
+    }
+
+    return $collector;
+}
+
+my @include = qw(
+
+);
+
+my @exclude = qw(
+
+);
+
+# Add static prereqs to the included modules list
+my $static_prereqs = do './t/00-report-prereqs.dd';
+
+# Merge all prereqs (either with ::Prereqs or a hashref)
+my $full_prereqs = _merge_prereqs(
+    ( $HAS_CPAN_META ? $cpan_meta_pre->new : {} ),
+    $static_prereqs
+);
+
+# Add dynamic prereqs to the included modules list (if we can)
+my ($source) = grep { -f } 'MYMETA.json', 'MYMETA.yml';
+my $cpan_meta_error;
+if ( $source && $HAS_CPAN_META
+    && (my $meta = eval { CPAN::Meta->load_file($source) } )
+) {
+    $full_prereqs = _merge_prereqs($full_prereqs, $meta->prereqs);
+}
+else {
+    $cpan_meta_error = $@;    # capture error from CPAN::Meta->load_file($source)
+    $source = 'static metadata';
+}
+
+my @full_reports;
+my @dep_errors;
+my $req_hash = $HAS_CPAN_META ? $full_prereqs->as_string_hash : $full_prereqs;
+
+# Add static includes into a fake section
+for my $mod (@include) {
+    $req_hash->{other}{modules}{$mod} = 0;
+}
+
+for my $phase ( qw(configure build test runtime develop other) ) {
+    next unless $req_hash->{$phase};
+    next if ($phase eq 'develop' and not $ENV{AUTHOR_TESTING});
+
+    for my $type ( qw(requires recommends suggests conflicts modules) ) {
+        next unless $req_hash->{$phase}{$type};
+
+        my $title = ucfirst($phase).' '.ucfirst($type);
+        my @reports = [qw/Module Want Have/];
+
+        for my $mod ( sort keys %{ $req_hash->{$phase}{$type} } ) {
+            next if grep { $_ eq $mod } @exclude;
+
+            my $want = $req_hash->{$phase}{$type}{$mod};
+            $want = "undef" unless defined $want;
+            $want = "any" if !$want && $want == 0;
+
+            if ($mod eq 'perl') {
+                push @reports, ['perl', $want, $]];
+                next;
+            }
+
+            my $req_string = $want eq 'any' ? 'any version required' : "version '$want' required";
+
+            my $file = $mod;
+            $file =~ s{::}{/}g;
+            $file .= ".pm";
+            my ($prefix) = grep { -e File::Spec->catfile($_, $file) } @INC;
+
+            if ($prefix) {
+                my $have = MM->parse_version( File::Spec->catfile($prefix, $file) );
+                $have = "undef" unless defined $have;
+                push @reports, [$mod, $want, $have];
+
+                if ( $DO_VERIFY_PREREQS && $HAS_CPAN_META && $type eq 'requires' ) {
+                    if ( $have !~ /\A$lax_version_re\z/ ) {
+                        push @dep_errors, "$mod version '$have' cannot be parsed ($req_string)";
+                    }
+                    elsif ( ! $full_prereqs->requirements_for( $phase, $type )->accepts_module( $mod => $have ) ) {
+                        push @dep_errors, "$mod version '$have' is not in required range '$want'";
+                    }
+                }
+            }
+            else {
+                push @reports, [$mod, $want, "missing"];
+
+                if ( $DO_VERIFY_PREREQS && $type eq 'requires' ) {
+                    push @dep_errors, "$mod is not installed ($req_string)";
+                }
+            }
+        }
+
+        if ( @reports ) {
+            push @full_reports, "=== $title ===\n\n";
+
+            my $ml = _max( map { length $_->[0] } @reports );
+            my $wl = _max( map { length $_->[1] } @reports );
+            my $hl = _max( map { length $_->[2] } @reports );
+
+            if ($type eq 'modules') {
+                splice @reports, 1, 0, ["-" x $ml, "", "-" x $hl];
+                push @full_reports, map { sprintf("    %*s %*s\n", -$ml, $_->[0], $hl, $_->[2]) } @reports;
+            }
+            else {
+                splice @reports, 1, 0, ["-" x $ml, "-" x $wl, "-" x $hl];
+                push @full_reports, map { sprintf("    %*s %*s %*s\n", -$ml, $_->[0], $wl, $_->[1], $hl, $_->[2]) } @reports;
+            }
+
+            push @full_reports, "\n";
+        }
+    }
+}
+
+if ( @full_reports ) {
+    diag "\nVersions for all modules listed in $source (including optional ones):\n\n", @full_reports;
+}
+
+if ( $cpan_meta_error || @dep_errors ) {
+    diag "\n*** WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING ***\n";
+}
+
+if ( $cpan_meta_error ) {
+    my ($orig_source) = grep { -f } 'MYMETA.json', 'MYMETA.yml';
+    diag "\nCPAN::Meta->load_file('$orig_source') failed with: $cpan_meta_error\n";
+}
+
+if ( @dep_errors ) {
+    diag join("\n",
+        "\nThe following REQUIRED prerequisites were not satisfied:\n",
+        @dep_errors,
+        "\n"
+    );
+}
+
+pass('Reported prereqs');
+
+# vim: ts=4 sts=4 sw=4 et:

xt/release/unused-vars.t

@@ -0,0 +1,6 @@
+use Test::More 0.96 tests => 1;
+use Test::Vars;
+
+subtest 'unused vars' => sub {
+all_vars_ok();
+};